MCP サーバー Obsidian Omnisearch

REST API インターフェースを通じて Obsidian Vault 検索機能を提供する FastMCP ベースのサーバー。

概要

このプロジェクトは、Obsidian Vault のノートをプログラムで検索できる検索サービスを実装します。FastMCP を使用することで、検索機能を他のサービスと統合できるツールとして公開できます。

Related MCP server: Obsidian MCP Server

特徴

• Obsidian Vaultのノートを検索する

• REST API統合

• 一致するノートへの絶対パスを返します

• FastMCPツールとの簡単な統合

前提条件

• Python 3.x

• Omnisearchプラグインがインストールされ実行されているObsidian

• FastMCPライブラリ

• 現役の黒曜石保管庫

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の MCP Server Obsidian Omnisearch を自動的にインストールするには:

npx -y @smithery/cli install @anpigon/mcp-server-obsidian-omnisearch --client claude

手動インストール

1. リポジトリをクローンします。

git clone https://github.com/anpigon/mcp-server-obsidian-omnisearch.git
cd mcp-server-obsidian-omnisearch

2. 依存関係をインストールします:

uv install

構成

サーバー実行時に、Obsidian の金庫パスがコマンド ライン引数として提供されるようになりました。

python server.py /path/to/your/obsidian/vault

使用法

Obsidian オムニサーチ API

Obsidian Omnisearch コミュニティ プラグインを実行する必要があります: https://publish.obsidian.md/omnisearch/Inject+Omnisearch+results+into+your+search+engine

クロードデスクトップ

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

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

{
  "mcpServers": {
    "obsidian-omnisearch": {
      "command": "uv",
      "args": [
        "--directory",
        "<dir_to>/mcp-server-obsidian-omnisearch",
        "run",
        "mcp-server-obsidian-omnisearch",
        "/path/to/your/obsidian/vault"
      ]
    }
  }
}

{
  "mcpServers": {
    "obsidian-omnisearch": {
      "command": "uvx",
      "args": [
        "mcp-server-obsidian-omnisearch",
        "/path/to/your/obsidian/vault"
      ]
    }
  }
}

APIリファレンス

検索ノート

• 関数: obsidian_notes_search(query: str)

• 説明: Obsidian ノートを検索し、一致するノートへの絶対パスを返します

• パラメータ:

  • query : 検索クエリ文字列

• 戻り値: 一致するノートへの絶対パスのリスト

発達

建築と出版

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

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/mcp-server-obsidian-omnisearch run mcp-server-obsidian-omnisearch

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

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

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

依存関係

• ファストMCP

• リクエスト

• urllib

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。