MCP Server Obsidian Omnisearch

MCP Server Obsidian Omnisearch

一个基于 FastMCP 的服务，通过 REST API 接口提供 Obsidian 知识库搜索功能。

概述

本项目实现了一项搜索服务，可让你以编程方式搜索 Obsidian 知识库中的笔记。它使用 FastMCP 将搜索功能公开为工具，以便与其他服务集成。

功能

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

前提条件

• Python 3.x
• 已安装并运行 Omnisearch 插件的 Obsidian
• FastMCP 库
• 已启用的 Obsidian 知识库

安装

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 MCP Server 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

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
• 或用户名／密码：--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

启动后，Inspector 会显示一个 URL，你可以在浏览器中访问该 URL 开始调试。

你也可以使用以下命令查看服务日志：

tail -n 20 -f ~/Library/Logs/Claude/mcp-server-mcp-server-obsidian-omnisearch.log

依赖项

• FastMCP
• requests
• urllib

许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

贡献

欢迎贡献！请随时提交 Pull Request。