Obsidian笔记管理服务器

黑曜石MCP服务器

轻量级 模型上下文协议（MCP） 服务器，使Cursor&Claude等人工智能助手能够对您的黑曜石保险库进行读写操作。

交互示例

• “为明天的standup创建一个新的注释，描述我今天所做的代码更改”（也应该使用Git）
• “查看我关于项目想法的笔记”
• “检查我有哪些与重构相关的工作要做”

工具

阅读

1. 获取所有文件名

   • 获取黑曜石保管库中所有文件名的列表
   • 有助于发现可用的文件

2. readMultipleFiles

   • 从黑曜石保险库检索指定文件的内容
   • 支持精确文件名、部分文件名或不区分大小写的匹配
   • 每个文件的内容都以“#file:filename”作为前缀，以便清晰识别

3. Getopentos

   • 从黑曜石保管库中的标记文件中检索所有打开的TODO项目
   • 查找未选中的复选框项（包含“-[]”的行）
   • 返回它们及其文件位置

写

1. updateFile内容
   • 使用新的标记内容更新黑曜石保管库中指定文件的内容
   • 如果文件不存在，将创建它
   • 自动创建任何必要的目录

安装和构建

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"
      ]
    }
  }
}

对于光标，请转到MCP选项卡 Cursor Settings （命令+换档+J）。使用以下命令添加服务器：

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

与其他解决方案的比较

虽然这种实现是有意轻量级的，但其他解决方案，如 jackstreamdev/黑曜石mcp工具 作为黑曜石插件，提供了一种功能更丰富的方法。

此独立服务器的优点是无需运行Obsidian应用程序即可直接访问文件系统。

资源

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