local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Allows interaction with Obsidian via the Local REST API community plugin. Capabilities include listing files in vault, retrieving file contents, searching across vault files, patching content into existing notes, and appending content to new or existing files.

Obsidian の MCP サーバー

ローカル REST API コミュニティプラグインを介して Obsidian と対話するための MCP サーバー。

コンポーネント

ツール

サーバーは Obsidian と対話するための複数のツールを実装しています。

list_files_in_vault: Obsidian の金庫のルートディレクトリにあるすべてのファイルとディレクトリを一覧表示します
list_files_in_dir: 特定のObsidianディレクトリ内のすべてのファイルとディレクトリを一覧表示します
get_file_contents: ボールト内の 1 つのファイルの内容を返します。
検索: 指定されたテキストクエリに一致する文書を保管庫内のすべてのファイルから検索します。
patch_content: 見出し、ブロック参照、または frontmatter フィールドを基準にして、既存のノートにコンテンツを挿入します。
append_content: ボールト内の新規ファイルまたは既存のファイルにコンテンツを追加します。
delete_file: 保管庫からファイルまたはディレクトリを削除します。

プロンプトの例

まずクロードにObsidianを使うように指示すると良いでしょう。そうすれば、常にそのツールが呼び出されます。

使用プロンプトは次のようになります:

最後のアーキテクチャコールノートの内容を取得して要約する
Azure CosmosDb が言及されているすべてのファイルを検索し、それが言及されているコンテキストを簡単に説明してください
前回の会議の議事録を要約し、「summary meeting.md」という新しいメモを作成してください。メールで送れるように、紹介文を追加してください。

構成

Obsidian REST API キー

Obsidian REST API キーを使用して環境を構成する方法は 2 つあります。

サーバー設定に追加（推奨）

{
  "mcp-obsidian": {
    "command": "uvx",
    "args": [
      "mcp-obsidian"
    ],
    "env": {
      "OBSIDIAN_API_KEY": "<your_api_key_here>",
      "OBSIDIAN_HOST": "<your_obsidian_host>"
    }
  }
}

次の必須変数を含む.envファイルを作業ディレクトリに作成します。

OBSIDIAN_API_KEY=your_api_key_here
OBSIDIAN_HOST=your_obsidian_host

注: キーは Obsidian プラグイン設定で見つかります。

クイックスタート

インストール

オブシディアン REST API

Obsidian REST API コミュニティプラグインを実行する必要があります: https://github.com/coddingtonbear/obsidian-local-rest-api

設定でインストールして有効にし、API キーをコピーします。

クロードデスクトップ

MacOSの場合: ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows の場合: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-obsidian": {
      "command": "uv",
      "args": [
        "--directory",
        "<dir_to>/mcp-obsidian",
        "run",
        "mcp-obsidian"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-obsidian": {
      "command": "uvx",
      "args": [
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY" : "<YOUR_OBSIDIAN_API_KEY>"
      }
    }
  }
}

発達

建物

配布用のパッケージを準備するには:

依存関係を同期し、ロックファイルを更新します。

uv sync

デバッグ

MCPサーバーはstdio経由で実行されるため、デバッグが困難になる場合があります。最適なデバッグ環境を実現するには、 MCP Inspectorの使用を強くお勧めします。

次のコマンドを使用して、 npm経由で MCP Inspector を起動できます。

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-obsidian run mcp-obsidian

起動すると、ブラウザでアクセスしてデバッグを開始できる URL がインスペクタに表示されます。

次のコマンドでサーバーログを監視することもできます。

tail -n 20 -f ~/Library/Logs/Claude/mcp-server-mcp-obsidian.log

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work