Obsidian MCP 服务器

一个轻量级的 Model Context Protocol (MCP) 服务器，使像 Cursor 和 Claude 这样的 AI 助手能够读取和写入您的 Obsidian 知识库。

示例交互

• "为明天的站立会议创建一个新的笔记，描述我今天所做的代码更改"（还应使用 Git）
• "查看关于项目想法的笔记"
• "检查与重构相关的待办事项"

工具

读取

1. getAllFilenames

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

2. readMultipleFiles

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

3. getOpenTodos

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

写入

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

安装与构建

bash
npm install obsidian-mcp-server
npm run build

与 Claude Desktop 和 Cursor 集成

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

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

对于 Cursor，请转到 MCP 标签页 Cursor 设置（command + shift + J）。使用以下命令添加一个服务器：

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

与其他解决方案的比较

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

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

资源

• Model Context Protocol 文档
• MCP 服务器仓库