palace-mcp

Obsidian 볼트를 AI 어시스턴트에게 Local REST API 플러그인을 통해 노출하는 MCP 서버입니다.

FastMCP로 구축되었습니다. 에이전트는 노트를 나열, 읽기, 쓰기, 검색, 삭제할 수 있습니다 — 그리고 Obsidian에서 현재 열려 있는 노트를 읽을 수도 있습니다.

사전 요구 사항

• Obsidian 및 Local REST API 플러그인이 설치되어 실행 중이어야 합니다.

• Python 3.12+

• uv (권장) 또는 pip

계속하기 전에 Obsidian의 플러그인 설정에서 API 키를 복사하세요.

Related MCP server: obsidian-local-mcp

설치

git clone <repo-url> palace-mcp
cd palace-mcp
uv sync

구성

플러그인의 자체 서명 인증서로 HTTPS를 사용하는 경우, 인증서 검증은 자동으로 건너뜁니다.

실행

stdio를 통해 서버를 시작합니다(MCP 클라이언트의 기본 전송 방식):

export OBSIDIAN_API_KEY="your-api-key"
uv run python server.py

또는 FastMCP를 통해:

uv run fastmcp run server.py

Cursor 설정

MCP 구성에 추가합니다(예: ~/.cursor/mcp.json):

{
  "mcpServers": {
    "obsidian-palace": {
      "command": "uv",
      "args": ["run", "python", "server.py"],
      "cwd": "/path/to/palace-mcp",
      "env": {
        "OBSIDIAN_API_KEY": "your-api-key-here"
      }
    }
  }
}

저장 후 Cursor를 다시 시작하거나 MCP 서버를 다시 로드하세요.

도구

추가 보호

일부 보관소 경로는 덮어쓰기 전용으로 취급됩니다. 해당 경로에 추가하면 단일 노트 안에 중복 콘텐츠가 조용히 쌓일 수 있으며, 나중에 감지하기 어렵습니다.

기본적으로 append_note는 다음 패턴과 일치하는 경로에서 거부됩니다:

• /Context/ (Context 폴더 아래의 모든 노트)

• /System/ (System 폴더 아래의 모든 노트)

• Index.md (Index.md라는 이름의 모든 파일)

대신 write_note를 사용하여 해당 노트를 교체하세요. 차단 목록은 PALACE_APPEND_DENY 환경 변수로 재정의할 수 있습니다.

라이선스

MIT