Anpigon MCP Server Obsidian Omnisearch

🚀 Obsidian OmnisearchのMCPサーバー

このプロジェクトは、FastMCPをベースにしたサーバーで、REST APIインターフェースを通じてObsidianノートライブラリの検索機能を提供します。

🚀 クイックスタート

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

✨ 主な機能

• Obsidianノートライブラリ内のノートを検索する
• REST APIとの統合
• 一致するノートの絶対パスを返す
• FastMCPツールとの簡単な統合

📦 インストール

前提条件

• Python 3.x
• ObsidianとそのOmnisearchプラグインのインストールと実行
• FastMCPライブラリ
• アクティブなObsidianノートライブラリ

インストール手順

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 Omnisearch API

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

Claude Desktop

• 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/ディレクトリにソースコードとホイール（wheel）の配布版が作成されます。

3. PyPIに公開します：

uv publish

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

• トークン：--token または UV_PUBLISH_TOKEN
• ユーザー名：--user または UV_PUBLISH_USER
• パスワード：--password または UV_PUBLISH_PASSWORD

📄 ライセンス

使用中に何か問題が発生したり、質問がある場合は、いつでもお問い合わせください。