JinDaGe - Obsidian Notes MCP Details

article

README

🚀 Obsidian MCP 服务器

Obsidian MCP 服务器是一个轻量级的模型上下文协议 (MCP) 服务器，它能让 AI 助手（如 Cursor 和 Claude）读取和写入您的 Obsidian 笔记 vault，为笔记管理带来更多便利。

🚀 快速开始

示例交互

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

✨ 主要特性

工具

读取

getAllFilenames
- 功能：获取 Obsidian 笔记 vault 中所有文件的文件名列表，方便发现可用文件。
readMultipleFiles
- 功能：从 Obsidian 笔记 vault 中检索指定文件的内容。
- 匹配方式：支持精确文件名、部分文件名或不区分大小写的匹配。
- 内容标识：每个文件的内容前会添加 '# 文件：filename' 以明确标识。
getOpenTodos
- 功能：检索 Obsidian 笔记 vault 中所有未完成的 TODO 项。
- 查找规则：查找未标记的 checkbox 项目（包含 '- [ ] ' 的行）。
- 返回信息：返回时附带其文件位置。

写入

updateFileContent
- 功能：使用新的 Markdown 内容更新指定文件在 Obsidian 笔记 vault 中的内容。
- 文件处理：如果文件不存在，则会自动创建，并自动创建任何必要的目录。

📦 安装指南

npm install obsidian-mcp-server
npm run build

💻 使用示例

与 Claude Desktop 和 Cursor 集成

Claude Desktop

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

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

Cursor

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

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

📚 详细文档

与其他解决方案的比较

尽管此实现故意保持轻量级，但其他解决方案如 jacksteamdev/obsidian-mcp-tools 提供了更功能丰富的 Obsidian 插件。此独立服务器的优势在于可以直接访问文件系统，而无需运行 Obsidian 应用程序。

Obsidian Notes