-
securityF
license-
qualityProvides semantic search capability over Obsidian vaults and exposes recent notes as resources to Claude through the MCP protocol.
Last updated -
8
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ファイルを参照してください。
貢献
貢献を歓迎します！お気軽にプルリクエストを送信してください。
Related MCP Servers
- -securityAlicense-qualityProvides a standardized interface for AI assistants to interact with Obsidian vaults through a local REST API, enabling reading, writing, searching, and managing notes.Last updated -58MIT License
- AsecurityAlicenseAqualityA server that enables AI agents to perform sophisticated knowledge discovery and analysis across Obsidian vaults through the Local REST API plugin, supporting complex multi-step workflows with advanced filtering and full content retrieval.Last updated -318MIT License
- AsecurityAlicenseAqualityEmpowers AI agents to deeply understand and interact with Obsidian vaults through the Local REST API, enabling advanced features like vault structure discovery, graph analysis, command execution, and batch file operations.Last updated -164MIT License