MCP Server Obsidian Omnisearch

概述

MCP 服务器 Obsidian Omnisearch 是基于 FastMCP 的服务，通过 REST API 提供 Obsidian 笔记库搜索功能。

先决条件

• Python 3.x
• Obsidian 安装并运行 Omnisearch 插件
• FastMCP 库
• 活跃的 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": "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 - 搜索查询字符串
• 返回: 匹配笔记的绝对路径列表

调试

推荐使用 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
uv publish