Obsidian MCP

🚀 Obsidian MCP (Model Context Protocol)

Obsidian MCPは、Model Context Protocolを使用してObsidianボールトと対話できるツールです。これにより、AIアシスタントは標準化されたインターフェースを介して、Obsidianボールト内のノートを読み取り、書き込み、操作することができます。

🚀 クイックスタート

前提条件

• Node.js 18以上
• Local REST APIプラグインがインストールされ、設定されたObsidian
• Local REST APIプラグインから生成されたAPIキー

MCPサーバーの設定（例：Claudeデスクトップアプリ）

1. このリポジトリをクローンします。
2. 依存関係をインストールします。

   npm install
   

3. プロジェクトをビルドします。

   npm run build
   

4. Claudeデスクトップアプリを設定して、このMCPサーバーを使用するようにします。

   {
      "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"を設定します。

✨ 主な機能

利用可能なツール

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

基本的な使用法

• readNote - 特定のノートの内容を読み取ります。

  {
    "path": "path/to/note.md"
  }
  

• readActiveNote - 現在アクティブなノートの内容を読み取ります。

  {}
  

• listNotes - ボールト全体または指定されたフォルダ以下のファイルとフォルダを再帰的にリストします。

  {
    "path": "optional/folder/path"
  }
  

• patchNote - 見出し、ブロック参照、またはフロントマターフィールドに対して、既存のノートに内容を挿入します。

  {
    "path": "path/to/note.md",
    "operation": "append|prepend|replace",
    "targetType": "heading|block|frontmatter",
    "target": "target_identifier",
    "content": "content to insert"
  }
  

• searchWithJsonLogic - JsonLogic形式のクエリを使用してObsidianノートを検索します。

  {
    "query": {
      // JsonLogic query object
    }
  }