Obsidian MCP

Obsidian MCP（モデルコンテキストプロトコル）

Obsidian MCPは、モデルコンテキストプロトコル（Model Context Protocol）を用いてObsidian Vaultとやり取りできるツールです。これにより、AIアシスタントは標準化されたインターフェースを介してObsidian Vault内のメモの読み取り、書き込み、操作が可能になります。

前提条件

• Node.js 18以上
• ローカル REST API プラグインがインストールおよび構成された Obsidian
• ローカルREST APIプラグインから生成されたAPIキー

MCP サーバーの設定 (例: Claude デスクトップ アプリ)

1. このリポジトリをクローンする
2. 依存関係をインストールします:
   npm install
3. プロジェクトをビルドします。
   npm run build
4. この MCP サーバーを使用するように Claude デスクトップ アプリを構成します。
   { "mcpServers": { "Obsidian": { "command": "node", "args": ["/Users/<Your Own Path>/obsisian-mcp/build/index.js"], "env": { "apiKey": "<Your API Token>", "port": "27123", "host": "127.0.0.1" } } } }

発達

.envを作成し、上記のように「apiKey」、「port」、「host」を設定します。

利用可能なツール

以下のツールが実装されています。

1. readNote - 特定のメモの内容を読む
   { "path": "path/to/note.md" }
2. readActiveNote - 現在アクティブなノートの内容を読み取る
   {}
3. listNotes - Vault 全体または指定されたフォルダ内のファイルとフォルダを再帰的に一覧表示します
   { "path": "optional/folder/path" }
4. patchNote - 見出し、ブロック参照、または前置フィールドを基準にして既存のノートにコンテンツを挿入します。
   { "path": "path/to/note.md", "operation": "append|prepend|replace", "targetType": "heading|block|frontmatter", "target": "target_identifier", "content": "content to insert" }
5. searchWithJsonLogic - JsonLogic形式のクエリを使用してObsidianノートを検索します
   { "query": { // JsonLogic query object } }