local-only server

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

Integrations

Provides searchable access to Obsidian vault notes through the Omnisearch plugin, returning absolute file paths to matching notes based on search queries

MCP サーバー Obsidian Omnisearch

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

概要

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

特徴

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

手動インストール

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

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

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

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 : 検索クエリ文字列
戻り値: 一致するノートへの絶対パスのリスト

発達

建築と出版

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

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

uv sync

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

uv build

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

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ファイルを参照してください。

貢献

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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

REST API インターフェースを通じて Obsidian Vault のプログラムによる検索機能を提供し、外部アプリケーションがメモを検索し、一致するドキュメントへの絶対パスを取得できるようにします。

Related Resources

Reddit Discussion about this server

Obsidian Omnisearch MCP Server