黑曜石MCP工具
](https://github.com/jacksteamdev/obsidian-mcp-tools/releases/latest)  
特性 | 安装 | 配置 | 故障排除 | 安全 | 发展 | 支持
⚠️ 项目已存档 我感谢所有在过去一年里下载了这个插件的用户。看着黑曜石商店的安装数量攀升至87k，真是有趣！我从未想过它会成为MCP相关的黑曜石插件的第一名。 这个项目最初是我的伴侣的爱的劳动，她正在使用黑曜石，想和她的笔记聊天。我们目前没有使用Obsidian，所以我决定退出，让在Obsidian生态系统中有既得利益的插件开发人员获得用户。 黑曜石社区插件商店至少发布了五种替代品，通过BRAT可以获得更多与MCP相关的测试版插件。我不会为特定的插件提出建议；我会让用户自行决定。
MCP Tools for Obsidian使Claude Desktop等AI应用程序能够通过模型上下文协议（MCP）安全地访问和使用您的黑曜石保险库。MCP是一个开放协议，它规范了人工智能应用程序如何与外部数据源和工具交互，同时保持安全性和用户控制。2.
此插件由两部分组成：
- 一个黑曜石插件，为您的保险库添加MCP功能
- 处理与AI应用程序通信的本地MCP服务器
安装此插件时，它将帮助您设置这两个组件。MCP服务器充当您的保险库和Claude Desktop等AI应用程序之间的安全桥梁。这意味着人工智能助手可以阅读你的笔记、执行模板和执行语义搜索，但只有在你允许的情况下，并且只能通过服务器的安全API。服务器从不允许AI应用程序直接访问您的vault文件。3.
隐私声明：当使用带有此插件的Claude Desktop时，默认情况下，您与Claude的对话不会用于训练Anthropic的模型。1.
特性
当连接到像Claude Desktop这样的MCP客户端时，此插件启用：
- 保险库访问：允许AI助手读取和参考您的笔记，同时维护您的保险库的安全\[^4\]
- 语义搜索：人工智能助手可以根据含义和上下文搜索你的保险库，而不仅仅是关键字\[^5\]
- 模板集成：通过人工智能交互、动态参数和内容生成执行黑曜石模板\[^6\]
所有功能都需要像Claude Desktop这样的MCP兼容客户端，因为此插件提供了启用这些集成的服务器组件。该插件不会直接修改Obsidian的功能，相反，它创建了一个安全的桥梁，允许AI应用程序以强大的方式与您的保险库协同工作。
先决条件
必需
- 黑曜石 v1.7.7或更高版本
- 克劳德桌面版 已安装并配置
- 本地REST API 使用API密钥安装和配置的插件
推荐
安装
\[！重要\] 此插件需要在您的计算机上本地运行的安全服务器组件。服务器作为签名的可执行文件分发，其完整的源代码可在 packages/mcp-server/。有关我们的安全措施和代码签名过程的详细信息，请参阅 安全 部分。- 从Obsidian的社区插件安装插件
- 在黑曜石设置中启用插件
- 打开插件设置
- 点击“安装服务器”下载并配置MCP服务器
点击安装按钮将：
- 下载适合您平台的MCP服务器二进制文件
- 配置Claude Desktop以使用服务器
- 设置必要的权限和路径
安装位置
- 服务器二进制文件：{vault}/.黑曜石/插件/黑曜岩mcp工具/bin/
- 日志文件:
- macOS：~/库/日志/黑曜石mcp工具 - Windows:%APPDATA%\\黑曜石mcp工具\\logs - Linux:~/.local/share/obsidian mcp工具/logs
配置
点击插件设置中的“安装服务器”按钮后，插件将自动：
- 下载相应的MCP服务器二进制文件
- 使用本地REST API插件的API密钥
- 配置Claude Desktop以使用MCP服务器
- 设置适当的路径和权限
虽然配置过程是自动化的，但安装服务器二进制文件和修改Claude Desktop配置需要您的明确许可。除此初始设置步骤外，不需要额外的手动配置。
故障排除
如果您遇到问题：
- 检查插件设置以验证：
- 已安装所有必需的插件 - 服务器安装正确 - 克劳德桌面已配置
- 查看日志：
- 打开插件设置 - 点击资源下的“打开日志” - 查找任何错误消息或警告
- 常见问题：
- 服务器无法启动：确保Claude Desktop正在运行 - 连接错误：验证本地REST API插件是否已配置 - 权限错误：尝试重新安装服务器
安全
二进制发布
- 所有版本都是使用GitHub Actions构建的，具有可复制的构建
- 二进制文件使用SLSA来源进行签名和认证
- 发布工作流在存储库中完全可审计
运行时安全
- MCP服务器以所需的最小权限运行
- 所有通信都是加密的
- API密钥使用特定于平台的凭据存储进行安全存储
二进制验证
MCP服务器二进制文件随 SLSA来源证明，它提供了二进制文件在何处以及如何构建的加密证明。这有助于确保您下载的二进制文件的完整性和来源。
要使用GitHub CLI验证二进制文件：
- 安装GitHub命令行界面：
# macOS (Homebrew)
brew install gh
# Windows (Scoop)
scoop install gh
# Linux
sudo apt install gh # Debian/Ubuntu- 验证二进制文件：
gh attestation verify --owner jacksteamdev 验证将显示：
- 二进制文件的SHA256哈希值
- 确认它是由此存储库的GitHub Actions工作流构建的
- 特定的工作流文件和创建它的版本标记
- 符合SLSA 3级构建要求
此验证确保二进制文件未被篡改，并且是直接从该存储库的源代码构建的。
报告安全问题
请通过我们的 安全策略. 不要在公共问题中报告安全漏洞。
发展
该项目使用具有基于特征的架构的单仓库结构。有关详细的项目架构文档，请参阅 .微规则.
使用Cline
这个项目中的一些代码是使用AI编码代理实现的 克莱恩.Cline使用 cline_docs/ 和那个 .clinerules 文件，以了解实现新功能时的项目架构和模式。
工作区
此项目使用 包子 工作空间结构：
packages/
├── mcp-server/ # Server implementation
├── obsidian-plugin/ # Obsidian plugin
└── shared/ # Shared utilities and types建筑
- 安装依赖项：
bun install- 构建所有包：
bun run build- 发展：
bun run dev需求
- 小圆面包 v1.1.42或更高版本
- TypeScript 5.0+
贡献
在投稿之前，请阅读我们的 贡献指南 包括我们的社区标准和行为期望。
- 分叉存储库
- 创建要素分支
- 进行更改
- 运行测试：
bun test- 提交拉取请求
我们欢迎真正的贡献，但保持严格的社区标准。在所有互动中保持尊重和建设性。
支持
- 💬 加入我们的Discord 用于提问、讨论和社区支持
- 打开一个问题 用于错误报告和功能请求
请阅读我们的 贡献指南 在发布之前。 我们保持高的社区标准，对有毒行为零容忍。
更新日志
看 有关详细的更改日志信息。
许可证
脚注
\[^1\]：有关Claude数据隐私和安全的信息，请参阅 Claude AI的数据使用政策 \[^2\]：有关模型上下文协议的更多信息，请参阅 MCP简介 \[^3\]：有关可用MCP客户端的列表，请参阅 MCP示例客户端 \[^4\]：需要黑名单插件本地REST API \[^5\]：需要黑曜石插件智能连接 \[^6\]：需要黑曜石插件Templater