Obsidian Index MCP サーバー

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

コンポーネント

リソース

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

• ノートはobsidian://<VAULT_NAME>/<NOTE_PATH> URLスキームでアドレス指定されます。

• ノートのメディアタイプはtext/markdownです

ツール

サーバーは 1 つのツールを実装します。

• search-notes : インデックスされたノートに対して意味検索を実行します

Related MCP server: @kazuph/mcp-obsidian

サーバーを実行する

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

• --vault : Obsidian vault へのパス（複数回指定可能）

• --database : ローカルデータベースファイルへのパス（存在しない場合は作成されます）

• --reindex : ボールト内のすべてのノートを再インデックスします (おそらく、今は毎回これを実行することが必要でしょう)

• --watch : ボールトの変更を監視し、それに応じてインデックスを更新します

クイックスタート

インストール

クロードデスクトップ

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

発達

建築と出版

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

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

uv sync

2. パッケージディストリビューションをビルドします。

uv build

これにより、 dist/ディレクトリにソースとホイールのディストリビューションが作成されます。

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

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