MCP Server Obsidian Omnisearch

MCP Server Obsidian Omnisearch

site icon
2025.04.05 13
Python笔记搜索REST APIObsidian 集成搜索工具开发效率
MCP Server Obsidian Omnisearch 是一个基于 FastMCP 的服务,提供通过 REST API 接口搜索 Obsidian 笔记库的功能。该服务允许用户以编程方式搜索 Obsidian 笔记,并返回匹配笔记的绝对路径,便于与其他服务集成。
View on GitHub

Overview

基本能力

产品定位

MCP Server Obsidian Omnisearch 是一个专门为 Obsidian 笔记库提供搜索功能的服务器,通过 REST API 接口实现高效搜索。

核心功能

  • 搜索 Obsidian 笔记库中的内容
  • 提供 REST API 接口
  • 返回匹配笔记的绝对路径
  • 与 FastMCP 工具轻松集成

适用场景

  • 需要以编程方式搜索 Obsidian 笔记库的场景
  • 需要将 Obsidian 搜索功能集成到其他服务中的场景
  • 开发效率工具集成

工具列表

  • FastMCP: 用于暴露搜索功能作为工具
  • Obsidian Omnisearch 插件: 提供搜索功能的基础

常见问题解答

  • 调试困难:建议使用 MCP Inspector 进行调试
  • 依赖问题:确保 Python 3.x 和 FastMCP 库已安装

使用教程

使用依赖

  • Python 3.x
  • Obsidian 及 Omnisearch 插件
  • FastMCP 库
  • 活跃的 Obsidian 笔记库

安装教程

通过 Smithery 安装

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

调试方式

使用 MCP Inspector 调试:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-server-obsidian-omnisearch run mcp-server-obsidian-omnisearch

查看服务器日志:

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

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。