anpigon/mcp-server-obsidian-omnisearch

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

30 stars 9 forks 品質 66 トレンド 11MIT

Repository Install

Omnisearch プラグイン API を使用して、Obsidian vault 内で検索できる MCP サーバー。シームレスなインテグレーションのためのノートにマッチする絶対パスを返します。 OST

概要

REST API インターフェイスにより、Obsidian vault の検索機能を提供する FastMCP ベースのサーバー。このプロジェクトでは、Obsidian vault ノートをプログラム的に検索できる検索サービスが実装されています。 FastMCP を使用して、他のサービスと連携できるツールとして検索機能を公開します。 - Obsidian vault ノートから検索 - REST API の統合 - ノートにマッチする絶対パスを返す - FastMCP ツールとの簡単な統合 - Python 3.x - Omnisearchプラグインをインストールして実行するObsidian - FastMCPライブラリ - アクティブObsidian vault MCP Server Obsidian Omnisearch for ClaudeデスクトップをSmiseryで自動的にインストールするには: Obsidian vault パスは、サーバーを実行したときにコマンドライン引数として提供されます。 Obsidian Omnisearchコミュニティプラグインの実行が必要です: https://publish.obsidian.md/omnisearch/Inject+Omnisearch+results+into+your+search+engine MacOSの場合:~/Library/Application\ Support/Claude/claude desktop config.json

概要（AI 翻訳）

REST API インターフェイスにより、Obsidian vault の検索機能を提供する FastMCP ベースのサーバー。

概要

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

##特徴

Obsidian vault ノートから検索
REST APIの統合
一致するノートに絶対パスを返す
FastMCP ツールとの簡単な統合

前提条件

Python 3.xの
OmsidianとOmnisearchプラグインをインストールして実行
FastMCPライブラリ
活動的なオブシディアンの金庫

インストール

##Smitheryでインストールする

MCP Server Obsidian Omnisearch for ClaudeデスクトップをSmiseryで自動的にインストールするには:

手動インストール

リポジトリのクローン化:
依存関係を取付けて下さい:

設定

Obsidian vault パスは、サーバーを実行したときにコマンドライン引数として提供されます。

使用法

##ObsidianオムニリサーチAPI

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

##Claudeデスクトップ

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

MCP Server Obsidian Omnisearch

A FastMCP-based server that provides Obsidian vault search functionality through a REST API interface.

Overview

This project implements a search service that allows you to search through Obsidian vault notes programmatically. It uses FastMCP to expose the search functionality as a tool that can be integrated with other services.

Features

Search through Obsidian vault notes
REST API integration
Returns absolute paths to matching notes
Easy integration with FastMCP tools

Prerequisites

Python 3.x
Obsidian with Omnisearch plugin installed and running
FastMCP library
Active Obsidian vault

Installation

Installing via Smithery

To install MCP Server Obsidian Omnisearch for Claude Desktop automatically via Smithery:

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

Manual Installation

Clone the repository:

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

Install dependencies:

uv install

Configuration

The Obsidian vault path is now provided as a command line argument when running the server:

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

Usage

Obsidian Omnisearch API

You need the Obsidian Omnisearch community plugin running: https://publish.obsidian.md/omnisearch/Inject+Omnisearch+results+into+your+search+engine

Claude Desktop

On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

On Windows: %APPDATA%/Claude/claude_desktop_config.json

API Reference

Search Notes

Function: obsidian_notes_search(query: str)
Description: Searches Obsidian notes and returns absolute paths to matching notes
Parameters:
- query: Search query string
Returns: List of absolute paths to matching notes

Development

Building and Publishing

To prepare the package for distribution:

Sync dependencies and update lockfile:

uv sync

Build package distributions:

uv build

GitHub で README 全文を見る

インストール

uvx mcp-server-obsidian-omnisearch /path/to/your/obsidian/vault

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

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