palace-mcp

Local REST API プラグインを介して Obsidian ボールトを AI アシスタントに公開する 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 サーバーを再読み込みしてください。

ツール

追記保護

一部のボールトパスは上書き専用として扱われます。追記すると、1 つのノート内に重複したコンテンツが静かに積み重なり、後から検出しにくくなることがあります。

デフォルトでは、append_note は次のパスに一致する場合に拒否されます:

• /Context/ (Context フォルダ配下の任意のノート)

• /System/ (System フォルダ配下の任意のノート)

• Index.md (Index.md という名前の任意のファイル)

これらのノートを置き換えるには、代わりに write_note を使用してください。PALACE_APPEND_DENY 環境変数で拒否リストを上書きできます。

ライセンス

MIT