Back to MCP directory
publicPublicdnsLocal runtime

mcp-server-obsidian-omnisearch

一个基于FastMCP的服务,通过REST API接口提供Obsidian笔记库的搜索功能

article

README

🚀 MCP 服务器 Obsidian Omnisearch

一个基于 FastMCP 的服务器,通过 REST API 接口提供 Obsidian 碎片库搜索功能,让您能以编程方式在 Obsidian 碎片库笔记中进行便捷搜索。

🚀 快速开始

该项目实现了一个搜索服务,允许您通过编程方式在 Obsidian 碎片库笔记中进行搜索。它使用 FastMCP 将搜索功能作为工具公开,以便与其他服务集成。

✨ 主要特性

  • 在 Obsidian 碎片库笔记中搜索
  • REST API 集成
  • 返回匹配笔记的绝对路径
  • 与 FastMCP 工具轻松集成

📦 安装指南

使用 Smithery 自动安装

通过 Smithery 自动为 Claude Desktop 安装 MCP 服务器 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
  1. 安装依赖项:
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"
      ]
    }
  }
}

依赖项

  • FastMCP
  • requests
  • urllib

📄 许可证

本项目根据 MIT 许可证发布 - 有关详细信息,请参阅 LICENSE 文件。

贡献

欢迎贡献!请随意提交 Pull Request。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client