🚀 Obsidian MCP 服务器

Obsidian MCP 服务器是一个轻量级的服务器，它基于 模型上下文协议 (MCP) 构建，能让 AI 助手（像 Cursor 和 Claude 这类）对您的 Obsidian 笔记 vault 进行读写操作，极大地提升了笔记管理的智能化水平。

🚀 快速开始

您可以通过以下命令完成安装与构建：

npm install obsidian-mcp-server
npm run build

要将您的 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

✨ 主要特性

示例交互

• 可以向服务器发出如“创建一个新笔记，描述我今天所做的代码更改，并安排明天的站会”（还应使用 Git）这样的指令。
• 能执行“检查我的项目创意相关笔记”的操作。
• 支持“查看我与重构相关的待办事项”的查询。

工具

读取

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

写入

1. updateFileContent
   • 功能：使用新的 Markdown 内容更新指定文件在 Obsidian 笔记 vault 中的内容。如果文件不存在，会自动创建，同时也会自动创建任何必要的目录。

📦 安装指南

npm install obsidian-mcp-server
npm run build

💻 使用示例

基础用法

以下是将 MCP 服务器与 Claude Desktop 集成的配置示例：

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

高级用法

以下是与 Cursor 集成的命令示例：

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

📚 详细文档

与其他解决方案的比较

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

资源

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