Obsidian MCP 服务器

“Obsidian” MCP 服务器的作用是什么？

Obsidian MCP 服务器是一款连接器，可让 Claude Desktop 或任何 Model Context Protocol (MCP) 客户端读取和搜索包含 Markdown 笔记的目录（如 Obsidian vault）。该服务器弥合了 AI 助手与个人或团队 Markdown 知识库之间的鸿沟，让你能够更方便地访问、搜索和利用笔记于开发工作流中。通过与 Obsidian 等外部数据源集成，服务器赋能 AI 工具执行信息检索、特定笔记获取或内容总结等任务，从而提升开发者和知识工作者的效率及知识管理能力。

提示词列表

在可用文档中未明确提及任何提示词模板。

资源列表

在所提供文档中未详细说明具体资源。

工具列表

根据文档及已有图片，安装后可用的工具如下（虽未在代码中逐一描述）：

• 读取笔记：允许读取 Obsidian vault 中某个特定笔记的内容。
• 搜索笔记：基于关键字或查询，在 vault 内进行笔记搜索。

注：工具名称及说明根据现有文档和图片推断，具体细节未作详细说明。

MCP 服务器的使用场景

• 个人知识管理：通过 Claude Desktop 无缝搜索、读取和获取个人 Obsidian vault 信息，让笔记可供 LLM 总结或答疑。
• 团队文档搜索：将共享 Markdown 目录作为团队成员或 AI 助手的可搜索资源，提升知识共享与新成员入职效率。
• 上下文 AI 辅助：将笔记中的相关信息作为上下文提供给 LLM，增强 AI 生成内容在开发或研究场景下的相关性与准确性。
• 自动化笔记摘要：利用 AI 总结 Obsidian vault 内的长笔记或文档，节省手动整理时间。

如何设置

Windsurf

1. 确保已安装 Node.js 和 Windsurf。
2. 打开你的 Windsurf 配置文件。
3. 在 mcpServers 节点添加以下内容：

   {
     "obsidian": {
       "command": "npx",
       "args": ["-y", "mcp-obsidian", "<path-to-your-vault>"]
     }
   }
   

4. 保存文件并重启 Windsurf。
5. 验证 MCP 服务器是否正在运行且可访问。

Claude

1. 确保已安装 Claude Desktop 和 Node.js。
2. 使用 Smithery 安装 Obsidian MCP：

   npx @smithery/cli install mcp-obsidian --client claude
   

3. 重启 Claude Desktop。
4. 确认 Obsidian MCP 工具已出现在 Claude Desktop 界面。

Cursor

1. 确保已安装 Node.js 和 Cursor。
2. 打开你的 Cursor 配置文件。
3. 按如下方式添加 Obsidian MCP 服务器：

   {
     "obsidian": {
       "command": "npx",
       "args": ["-y", "mcp-obsidian", "<path-to-your-vault>"]
     }
   }
   

4. 保存并重启 Cursor。
5. 在 Cursor 工具列表中检查 Obsidian MCP 服务器。

Cline

1. 安装 Node.js 和 Cline。
2. 编辑你的 Cline 配置文件。
3. 包含 Obsidian MCP 服务器：

   {
     "obsidian": {
       "command": "npx",
       "args": ["-y", "mcp-obsidian", "<path-to-your-vault>"]
     }
   }
   

4. 保存配置并重启 Cline。
5. 在界面中验证 Obsidian MCP 是否可用。

API 密钥安全

如 Obsidian MCP 服务器或 vault 需要认证或 API 密钥，请使用环境变量保障安全：

{
  "obsidian": {
    "command": "npx",
    "args": ["-y", "mcp-obsidian", "<path-to-your-vault>"],
    "env": {
      "OBSIDIAN_API_KEY": "${env:OBSIDIAN_API_KEY}"
    },
    "inputs": {
      "vaultPath": "<path-to-your-vault>"
    }
  }
}

在流程中如何使用该 MCP

在 FlowHunt 中集成 MCP

要将 MCP 服务器集成到 FlowHunt 工作流中，首先将 MCP 组件添加到流程并连接到你的 AI 代理：

点击 MCP 组件以打开配置面板。在系统 MCP 配置区域，使用如下 JSON 格式填入你的 MCP 服务器信息：

{
  "obsidian": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

配置完成后，AI 代理即可用作该 MCP 工具，具备所有功能和能力。请记得将 “obsidian” 替换为实际 MCP 服务器名称，并将 URL 替换为你自己的 MCP 服务器地址。

概览

综上，Obsidian MCP 服务器易于设置，可实现 Obsidian vault 的搜索与检索，但缺乏详细的提示词模板、明确的资源定义，以及诸如采样、roots 等高级 MCP 特性。不过，它为让 Obsidian 笔记可被 AI 访问提供了必需的工具。

MCP 评分

考虑到其目标明确、易于安装，以及为 Obsidian 用户带来的实际效用，我给这个 MCP 服务器的评分为 6/10。它非常适合自身使用场景，但在更广泛的可扩展性和文档深度方面还存在不足。