Obsidian MCP 服务器

一个轻量级的 模型上下文协议 (MCP) 服务器，使 AI 助手（如 Cursor 和 Claude）能够读取和写入您的 Obsidian vault。

交互示例

• "创建一个新的笔记，用于明天的站立会议，描述我今天所做的代码更改" (应该也使用 Git)
• "查看我关于项目想法的笔记"
• "查看我有哪些与重构相关的待办事项"

工具

读取

1. getAllFilenames

   • 获取 Obsidian vault 中所有文件名的列表
   • 用于发现有哪些文件可用

2. readMultipleFiles

   • 检索 Obsidian vault 中指定文件的内容
   • 支持精确文件名、部分文件名或不区分大小写的匹配
   • 每个文件的内容都以 '# File: filename' 为前缀，以便清晰识别

3. getOpenTodos

   • 检索 Obsidian vault 中 markdown 文件中的所有未完成的 TODO 项
   • 查找未选中的复选框项目（包含 '- [ ] ' 的行）
   • 将它们及其文件位置一起返回

写入

1. updateFileContent
   • 使用新的 markdown 内容更新 Obsidian vault 中指定文件的内容
   • 如果文件不存在，则会创建该文件
   • 自动创建任何必要的目录

安装与构建

npm install obsidian-mcp-server
npm run build

与 Claude Desktop 和 Cursor 集成

要将您的 MCP 服务器与 Claude Desktop 一起使用，请将其添加到您的 Claude 配置中：

{
  "mcpServers": {
    "obsidian": {
      "command": "node",
      "args": [
        "obsidian-mcp-server/build/index.js",
        "/path/to/your/vault"
      ]
    }
  }
}

对于 Cursor，请转到 MCP 选项卡 Cursor Settings (command + shift + J)。 使用以下命令添加服务器：

node obsidian-mcp-server/build/index.js /path/to/your/vault

与其他解决方案的比较

虽然此实现是有意轻量级的，但其他解决方案（如 jacksteamdev/obsidian-mcp-tools）作为 Obsidian 插件提供了更丰富的功能。

此独立服务器的优势在于可以直接访问文件系统，而无需运行 Obsidian 应用程序。

资源

• 模型上下文协议文档
• MCP 服务器仓库