黑曜石脑转储和上下文MCP
一个模块化的MCP（模型上下文协议）服务器，将Claude连接到您的黑曜石保险库。 最初是一个自动组织杂乱课堂笔记的简单脚本，现在已经演变成一个完整的 金库大脑 系统。它将你的黑曜石笔记变成一个持久的、与提供者无关的AI上下文层。
核心功能
- 读写Vault注释：授予Claude本机访问权限，以读取、追加、搜索和覆盖vault中的任何笔记。
- 批量和批量操作：使用优化
BulkUpdate工具和批处理重新加载功能，以高效地执行操作，大大减少UI延迟和API令牌使用。 - 无缝增量索引：使用本机修改时间戳(
MTime)内置轻量级_index.md文件。Claude可以高效地同步更改，而无需不断重新读取整个保险库。 - 合成引擎：将聊天会话提炼成原子知识块，并生成便携式
AI_CONTEXT.md该文件旨在安全地引导跨AI工作流程，而无需手动复制粘贴。
“第二大脑”工作流程和提示
服务器提供专门的提示（可通过Claude Desktop附件菜单访问），以自动化您的笔记生命周期。
organize_notes
- 用例：清理杂乱、无结构的文本。 - 它做什么：获取原始文本，将其重新格式化为干净的Markdown（带有标题、项目符号，甚至Mermaid.js图表），并将其直接保存到vault中的文件中。
distill_session
- 用例：在长时间的头脑风暴会议结束时运行此程序。 - 它做什么：从对话中获取原子“知识块”，向您展示模拟预览，并在更新时将批准的事实直接批量保存到您的第二个大脑目录中 _index.md.
rebuild_index
- 用例：手动编辑黑曜石保管库中的文件后运行此操作。 - 它做什么：执行智能增量扫描。它将磁盘文件时间戳与内部时间戳进行比较 _index.md，仅对更改的文件进行汇总。
generate_context_snapshot
- 用例：定期运行此程序以综合保管库的状态。 - 它做什么：编写简明 AI_CONTEXT.md 表示您是谁、活动项目、优先级和最近决策的文件。这个工件可以安全地冷粘贴到ChatGPT、Gemini或新的Claude会话中，这样你就不必重新解释自己了。
服务器架构
使用标准Python工具和 mcp 库，代码库是模块化的：
mcp_instance.py：中央FastMCP初始化。resources.py：显示只读note://{name}URI。tools.py：显示实用程序功能(get_note,search_notes)以及批量行动(get_notes_batch,update_notes_bulk).prompts.py：显示预定义代理工作流（提取、快照、重建）的逻辑。models.py：Pydantic模式验证正确的批量更新参数。
______________________________________________________________________
安装说明
1.克隆回购
git clone
cd 2.安装依赖项（通过uv）
因为它依赖于现代Python生态系统， uv 强烈建议用于依赖关系管理。
uv sync*（这会自动创建一个虚拟环境并安装 mcp, python-dotenv，以及其他所需的包。)*
3.连接您的黑曜石保险库
创建一个 .env 在克隆存储库的根目录中创建文件，并设置绝对vault路径：
OBSIDIAN_VAULT_PATH="C:\Users\YourName\Documents\ObsidianVault"4.添加到克劳德桌面
您必须使用Claude应用程序配置注册MCP服务器。打开配置文件：
- 视窗:
AppData\Roaming\Claude\claude_desktop_config.json
在下面添加以下条目 mcpServers:
{
"mcpServers": {
"Notes": {
"command": "C:\\Users\\YourName\\.local\\bin\\uv.EXE",
"args": [
"run",
"--directory",
"C:\\Users\\YourName\\mcp_test",
"python",
"-m",
"mcp_server_notes"
]
}
}
}关键的：你 *必须* 更新 YourName 在这两个 command 和 --directory 参数分别指向您的绝对UV路径和存储库克隆路径。
5.重启克劳德
完全重新启动Claude Desktop，现在您应该看到您的mcp服务器在（+）->连接器中运行。