Obsidian MCP

Obsidian 볼트에 AI 어시스턴트(Claude, Cursor 등)가 접근할 수 있게 해주는 MCP (Model Context Protocol) 서버입니다. 폴더를 탐색하고, 노트를 읽고, 생성, 편집, 이동, 이름 변경, 삭제할 수 있습니다 — 모두 AI 채팅에서 가능합니다.

요구 사항

• Python 3.10+

• uv (권장) 또는 pip

• 로컬 컴퓨터의 Obsidian 볼트

Related MCP server: mcp-obsidian

설치

# Clone the repo
git clone https://github.com/your-username/obsidian-mcp
cd obsidian-mcp

# Copy the env template and set your vault path
cp .env.example .env

.env 파일을 편집하고 볼트 경로를 설정하세요:

OBSIDIAN_VAULT_PATH="/Users/you/Documents/MyVault"

Obsidian에서 볼트 경로를 찾으려면: 설정 → 정보 → 볼트 경로.

서버 실행

개발 (MCP Inspector UI 사용)

uv run mcp dev server.py

그러면 브라우저에서 MCP Inspector가 열리며 모든 도구를 대화형으로 테스트할 수 있습니다.

프로덕션

uv run server.py

Cursor에 연결

.cursor/mcp.json (또는 Cursor 전역 MCP 설정)에 다음을 추가하세요:

{
  "mcpServers": {
    "obsidian": {
      "command": "python",
      "args": ["/absolute/path/to/obsidian-mcp/server.py"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
      }
    }
  }
}

/absolute/path/to/obsidian-mcp/server.py를 사용자 컴퓨터의 server.py 실제 경로로 바꾸고, /path/to/your/vault를 볼트 경로로 바꾸세요 (Obsidian에서 찾으려면: 설정 → 정보 → 볼트 경로).

Claude Desktop에 연결

claude_desktop_config.json에 다음을 추가하세요:

{
  "mcpServers": {
    "obsidian": {
      "command": "uv",
      "args": ["run", "/absolute/path/to/obsidian-mcp/server.py"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
      }
    }
  }
}

사용 가능한 도구

모든 경로는 볼트 루트를 기준으로 합니다. 예: "Projects/App/roadmap.md".

라이선스

MIT