obsidian-mcp-server

obsidian-mcp-server

1
file_systems

The Obsidian MCP Server is a Protocol Stdio server designed to integrate with LLM Agent, enabling Python-based manipulations of Obsidian's functionalities. It provides robust features for managing vaults and files, enhancing the usability of Obsidian tools.

OBSIDIAN-MCP-SERVER

LLM Agent와 연동 가능한 Model Context Protocol (MCP) Stdio 서버입니다. 이 서버는 LLM Agent가 Obsidian 관련 기능을 활용할 수 있도록 Python 기반의 Obsidian 관련 기능들을 제공합니다.

기능

Vault 관리

  • Vault 생성
  • Vault 삭제
  • Vault 목록 조회
  • Vault 정보 조회
  • Vault 설정 조회
  • Vault 설정 변경

파일 관리

  • Vault 파일 목록 조회
  • Vault 파일 작성(생성/수정)
  • Vault 파일 삭제

설치 방법

  1. 저장소 클론
git clone https://github.com/your-username/obsidian-mcp-server.git
cd obsidian-mcp-server
  1. 가상 환경 생성 및 활성화
python -m venv venv
source venv/bin/activate  # Linux/Mac
# 또는
.\venv\Scripts\activate  # Windows
  1. 의존성 설치
pip install -r requirements.txt
  1. 환경 변수 설정 .env 파일을 생성하고 다음 내용을 추가합니다:
OBSIDIAN_VAULT_PATH=/path/to/your/obsidian/vault

사용 방법

서버 실행

python main.py

API 사용 예시

Vault 생성
{
    "jsonrpc": "2.0",
    "method": "create_vault",
    "params": {
        "vault_name": "my_vault",
        "path": "/optional/custom/path"
    },
    "id": 1
}
Vault 목록 조회
{
    "jsonrpc": "2.0",
    "method": "list_vaults",
    "params": {},
    "id": 2
}
파일 작성
{
    "jsonrpc": "2.0",
    "method": "write_vault_file",
    "params": {
        "vault_name": "my_vault",
        "file_path": "notes/example.md",
        "content": "# Example Note\n\nThis is a test note."
    },
    "id": 3
}

에러 코드

  • -32000: 일반 오류
  • -32001: Vault를 찾을 수 없음
  • -32002: Vault가 이미 존재함
  • -32003: 파일을 찾을 수 없음
  • -32004: 경로를 찾을 수 없음
  • -32005: 설정 파일을 찾을 수 없음
  • -32006: 잘못된 설정
  • -32007: 파일 작업 오류
  • -32008: 잘못된 요청
  • -32009: 환경 변수 설정 오류
  • -32010: Obsidian 디렉토리 오류

응답 형식

성공 응답

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "status": "success",
        "message": "Operation completed successfully",
        "data": {}
    }
}

오류 응답

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": -32001,
        "message": "Vault 'my_vault' does not exist"
    }
}

라이선스

MIT License

Cursor 설치 방법

Cursor에서 이 MCP 서버를 사용하려면 다음과 같이 설정하세요:

"obsidian-mcp-server": {
    "transport": "stdio",
    "command": "/path/to/your/venv/bin/python",
    "args": ["/path/to/your/obsidian-mcp-server/main.py"],
    "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault"
    }
}

각 경로를 자신의 환경에 맞게 수정하세요:

  • /path/to/your/venv/bin/python: Python 가상환경의 Python 실행 파일 경로
  • /path/to/your/obsidian-mcp-server/main.py: 이 프로젝트의 main.py 파일 경로
  • /path/to/your/obsidian/vault: Obsidian Vault 경로