黑曜岩拱顶mcp
MCP服务器,用于AI代理在开发过程中记录见解和决策。
在迷你PC(Proxmox LXC)上无头运行。通过rclone(谷歌云端硬盘)写入黑曜石金库。
概念
代理人写。人类阅读。
服务器是一个结构化的写入端点。代理在工作时附加开发日志和ADR,范围 通过git存储库和会话。阅读、总结和任务管理发生在 装备黑曜石的机器。
先决条件
- 包子 1.0+
- Vault目录可在以下位置访问
VAULT_PATH
安装并运行
bun install
VAULT_PATH=/mnt/vault bun run src/index.ts复制 .env.example 到 .env 以持久化环境变量。
开发
bun run src/index.ts # dev (auto-loads .env, no build needed)
bun test # run tests
bun build # bundle to dist/ (optional, for production)MCP注册
claude mcp add obsidian-vault --transport http http://:1065/mcp工具
| 工具 | 说明 |
|---|---|
devlog_append | 将结构化日志条目附加到会话devlog文件 |
devlog_tail | 从会话开发日志中读取最后N个条目 |
adr_write | 创建新的ADR(自动编号,内容最多500个字符) |
adr_delete | 按编号删除ADR |
adr_index | 列出存储库的所有ADR |
adr_view | 阅读特定ADR |
看 代理商.md 用于完整的输入/输出规格。
