Obsidian MCP Server

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

示例交互

• “创建一个新的笔记，描述我今天所做的代码更改，以便明天的站会使用”（应同时使用Git）
• “检查我的关于项目想法的笔记”
• “检查与重构相关的待办事项”

工具

读取

1. getAllFilenames

   • 获取Obsidian知识库中所有文件名的列表
   • 有助于发现可用的文件

2. readMultipleFiles

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

3. getOpenTodos

   • 从Obsidian知识库中的markdown文件中检索所有未完成的待办事项
   • 查找未选中的复选框项（包含“- [ ] ”的行）
   • 返回它们及其文件位置

写入

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

安装与构建

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设置（快捷键：command + shift + J）。使用以下命令添加一个服务器：

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

与其他解决方案的比较

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

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

资源

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