MCP Server Obsidian Omnisearch

MCP Server Obsidian Omnisearch

未知

GitHub
Created Byanpigonanpigon

概述

这是一个基于 FastMCP 的服务器，通过 REST API 提供 Obsidian 仓库搜索功能，方便您以编程方式搜索笔记内容。

前提条件

  • Python 3.x
  • Obsidian 安装了 Omnisearch 插件
  • 活跃的 Obsidian 仓库

安装步骤

# 克隆仓库
git clone https://github.com/anpigon/mcp-server-obsidian-omnisearch.git
cd mcp-server-obsidian-omnisearch

# 安装依赖
uv install

运行服务器

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

配置 Claude Desktop

文件位置

  • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%/Claude/claude_desktop_config.json

配置示例

{
  "mcpServers": {
    "obsidian-omnisearch": {
      "command": "uvx",
      "args": [
        "mcp-server-obsidian-omnisearch",
        "/path/to/your/obsidian/vault"
      ]
    }
  }
}

API 使用

搜索笔记函数:

  • obsidian_notes_search(query: str)
  • 返回匹配笔记的绝对路径列表

调试

使用 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

构建与发布

# 更新依赖
uv sync

# 构建包
uv build

# 发布到 PyPI
uv publish

许可证

MIT 许可证