Obsidian Index MCP server

Obsidian Index MCP サーバー

Obsidian の Vault をセマンティック検索し、最近のノートをリソースとして公開する MCP サーバーです。

コンポーネント

リソース

サーバーは、Vault 内で最近変更されたノートをリソースとして MCP クライアントに公開します。

• ノートは obsidian://<VAULT_NAME>/<NOTE_PATH> URL スキームで指定します
• ノートのメディアタイプは text/markdown です

ツール

サーバーは次のツールを実装しています。

• search-notes：インデックス化されたノートをセマンティック検索します

サーバーの実行

uv run obsidian-index mcp --vault <VAULT_PATH> --database <DATABASE_PATH> --reindex --watch

• --vault：Obsidian Vault のパス（複数回指定できます）
• --database：ローカルデータベースファイルのパス（存在しない場合は作成されます）
• --reindex：Vault 内のすべてのノートを再インデックス化します（現時点では、実行するたびに指定することをおすすめします）
• --watch：Vault 内の変更を監視し、それに応じてインデックスを更新します

クイックスタート

インストール

Claude Desktop

MacOS の場合：~/Library/Application\ Support/Claude/claude_desktop_config.json Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

開発中／未公開サーバーの設定

``` "mcpServers": { "obsidian-index": { "command": "uv", "args": [ "--directory", "", "run", "obsidian-index", "--database", "", "--vault", "", "--reindex", "--watch" ] } } ```

公開済みサーバーの設定

``` "mcpServers": { "obsidian-index": { "command": "uvx", "args": [ "obsidian-index", "--database", "", "--vault", "", "--reindex", "--watch" ] } } ```

開発

ビルドと公開

パッケージを配布できる状態にするには、次の手順を実行します。

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

uv sync

2. パッケージの配布物をビルドします。

uv build

これにより、dist/ ディレクトリにソース配布物と wheel 配布物が作成されます。

3. PyPI に公開します。

uv publish

注：PyPI の認証情報は、環境変数またはコマンドフラグで設定する必要があります。

• トークン：--token または UV_PUBLISH_TOKEN
• またはユーザー名／パスワード：--username／UV_PUBLISH_USERNAME および --password／UV_PUBLISH_PASSWORD

デバッグ

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

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

npx @modelcontextprotocol/inspector uv --directory <PATH_TO_PROJECT> run obsidian-index

起動すると、Inspector に URL が表示されます。その URL にブラウザーからアクセスすると、デバッグを開始できます。