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
手动安装
- 克隆仓库:
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 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。
Scan to contact