使用说明
🚀 黑曜石MCP终极版（直接文件访问）
最可靠的连接方式 克劳德桌面 到你的 黑曜石保险库.
与其他需要“本地REST API”或“Obsidian MCP”插件（经常中断或需要打开Obsidian）的MCP服务器不同，此服务器使用 直接文件访问。它直接与您的文件系统通信，即使在Obsidian关闭时，也能使其更快、更稳定、更实用。
✨ 为什么是这个版本？
大多数黑曜石MCP只允许您读取或覆盖整个文件。这款“终极版”增加了高级用户功能：
- 部分编辑： 使用
patch_note在不重写整个文件的情况下查找和替换文本。 - 维基链接分辨率： 克劳德现在可以“跟随”了
[[Links]]查找实际文件路径。 - 元数据提取： 深入了解YAML frontmatter和属性。
- 文件管理： 移动、重命名、删除和创建目录。
🛠️ 设置
1.安装
将此仓库克隆到计算机上的永久文件夹中：
git clone https://github.com/YOUR_USERNAME/obsidian-mcp-ultimate.git
cd obsidian-mcp-ultimate
npm install
2.配置
将服务器添加到Claude Desktop配置文件中：
- macOS：
~/Library/Application Support/Claude/claude_desktop_config.json - 窗户：
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"obsidian": {
"command": "node",
"args": ["/ABSOLUTE/PATH/TO/index.js"],
"env": {
"OBSIDIAN_VAULT_PATH": "/ABSOLUTE/PATH/TO/YOUR/VAULT"
}
}
}
}
（注意：使用正斜杠 / 即使在Windows上，也可以使用双反斜杠 \\.)
🧰 工具集
| 工具 | 说明 |
|---|---|
list_notes |
递归列出所有 .md vault中的文件。 |
read_note |
读取笔记的全部内容。 |
patch_note |
新 查找并替换注释中的特定文本。 |
search_notes |
在整个vault中进行全文搜索。 |
resolve_link |
新 转换a [[Wikilink]] 转换为可用的文件路径。 |
Youtube |
新 提取YAML前体/属性。 |
Notes |
创建或覆盖注释。 |
append_note |
快速将文本添加到注释底部。 |
move_note |
新 重命名或移动文件和文件夹。 |
delete_note |
新 永久删除笔记。 |
create_directory |
新 在vault中创建新文件夹。 |
💡 使用专业提示
以下链接
如果克劳德看到这样的链接 [[Meeting Notes 2024]]，它可能不知道该文件在哪里。它应该首先调用 resolve_link(link_text: "Meeting Notes 2024") 那么，要找到那条路 read_note.
安全编辑
与其让克劳德“更新我的笔记”，不如让它：
“在我的项目注释中找到以“状态：”开头的行，并将其替换为“状态：已完成”。”
这触发了 patch_note，对于大文件来说，这比覆盖整个文件要安全得多。
⚠️ 安全免责声明
此服务器具有 删除 和 覆盖 能力。虽然它只根据您的命令行事，但强烈建议您 黑曜石同步, Git，或为您的保管库启用系统备份（时间机器/文件历史记录）。
🤝 贡献
发现错误或想添加 ripgrep 大型金库的集成？欢迎PR！
许可证
麻省理工学院
