使用说明
黑曜岩拱顶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://<SERVER_IP>:1065/mcp
工具
| 工具 | 说明 |
|---|---|
devlog_append |
将结构化日志条目附加到会话devlog文件 |
devlog_tail |
从会话开发日志中读取最后N个条目 |
adr_write |
创建新的ADR（自动编号，内容最多500个字符） |
adr_delete |
按编号删除ADR |
adr_index |
列出存储库的所有ADR |
adr_view |
阅读特定ADR |
看 代理商.md 用于完整的输入/输出规格。
