Obsidian Index MCP Server

local-only server

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

Integrations

  • Handles notes in Markdown format, exposing them with the 'text/markdown' media type for search and access.

  • Provides semantic search over Obsidian vaults and exposes recently modified notes as resources, allowing access to Markdown notes within Obsidian knowledge bases.

Obsidian Index MCP サーバー

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

コンポーネント

リソース

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

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

ツール

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

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

サーバーを実行する

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
  1. パッケージディストリビューションをビルドします。
uv build

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

  1. 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 がインスペクタに表示されます。

-
security - not tested
F
license - not found
-
quality - not tested

Obsidian Vault 上でセマンティック検索機能を提供し、MCP プロトコルを通じて最近のメモをリソースとして Claude に公開します。

  1. Components
    1. Resources
    2. Tools
  2. Run the server
    1. Quickstart
      1. Install
    2. Development
      1. Building and Publishing
      2. Debugging
    ID: 1mr561pxj8