@ cavdax/ mcp- 服务器
加利福尼亚州 - 背景行动和经核实的决定 自主评估
附录 MCP 由 FalkorDB GraphBLAS 支持的服务器
Blocks AI 编码代理从基于 Stale 或被取代的架构决定写入代码. 执行 示范背景协议 2024-11-05 与 Cursor 、 Claude Code 和 Claude Desktop 进行零配置集成.
快速启动
光标( 项目级别) .cursor/mcp.json(中文(简体) )
{
"mcpServers": {
"cavdax": {
"command": "npx",
"args": ["-y", "@cavdax/mcp-server"]
}
}
}
Claude 代码 CLI
claude mcp add cavdax npx -y @cavdax/mcp-server
Claude 桌面 (claude_desktop_config.json(中文(简体) )
{
"mcpServers": {
"cavdax": {
"command": "npx",
"args": ["-y", "@cavdax/mcp-server"]
}
}
}
主机 Entertainment SSE (Cursor / 任何 SSE 有能力的客户端)
{
"mcpServers": {
"cavdax-cloud": {
"url": "https://cavdax.sahnirmaan.live/api/mcp/sse",
"transport": "sse"
}
}
}
CLI 命令
npx @cavdax/mcp-server # Start MCP stdio server (default)
npx cavdax mcp # Start MCP stdio server (explicit)
npx cavdax ingest --repo . # Ingest ADRs from current repo into FalkorDB
npx cavdax check --staged # Validate staged files (git pre-commit hook)
npx cavdax check --staged --strict # ...and fail if FalkorDB is unreachable (CI)
npx cavdax check --pr 42 # Validate PR #42 changed files (CI)
npx cavdax gate --repo org/repo --sha <commit_sha> [--strict] # Verify PR commit against invariants in CI/CD
npx cavdax doctor # Diagnose FalkorDB & MCP readiness
MCP 工具已曝光
| 工具 | 说明 |
|---|---|
apply_code_change | 仅在引用时写入文件( 已关闭到 repo root) decision_id 具有因果关系。 硬反对僵持,作废和决定不明. |
revalidate_decision | 将无效的决定归档,并建立一个以替代发展成果评估为基础的新决定. |
check_intent_clearance | 飞行前检查 在写入代码前拨打以查找是否 decision_id 仍然有效,没有产生任何东西。 带 decision_id (必须), target_file 财务报告和审定财务报表 proposed_action。 。 。 . |
acquire_decision_lock | 租赁独家锁上一个决定 所以两个特工不能马上改变 带 decision_id, (中文(简体) ), agent_id选项 ttl_ms 财务报告和审定财务报表 reason。 。 。 . |
release_decision_lock | 释放一个锁 由呼叫代理持有. |
query_causal_graph | 检查因果图( 选择一个) node_id)检查节点状态和依赖路径. |
export_graph_image | 生成一个独立的 SVG 或 PNG 矢量快照,用于 PR 文物和可视调试的活性因子图. |
关于决定锁. 锁被租赁(5秒到5分),并被保存在一个MCP服务器进程的内存中. 他们阻止两个共享服务器的特工 立刻改变同一决定 每一个开始自己的IDE或代理
npxstdio过程得到自己的锁表,所以这些过程不会看到对方的锁. 对于跨不同客户端的多代理安全,将其指向一个共享服务器,如主机SSE端点.
FalkorDB 设置( 本地)
docker run -d --name falkordb -p 6379:6379 falkordb/falkordb:latest
npx cavdax doctor
npx cavdax ingest --repo . # ADRs may declare decision_id / decision_title in frontmatter; plain Markdown ADRs (no frontmatter) are also parsed
模式
| 模式 | 何时 | 行为 |
|---|---|---|
| 现场直播 | FalkorDB 可达到 | 真实的因果门查询,只写在批准后的文件,审计节点记录. 答复正在进行 "mode": "live"。 。 。 . |
| 模拟 | FalkorDB 无法获取 | 模拟演示图 DEC-102 已经很僵硬了 授权的写作仍然停留在磁盘上。 未知的决定ID被拒绝 。 每一个反应都带有 "simulated": true。 。 。 . |
CAVDAX_MODE=auto (默认)在可能时选择直播,并在每次通话时重复. CAVDAX_MODE=live 从来没有模拟和失败关闭. CAVDAX_MODE=simulation 从来没有连接.
环境变量
| 变量 | 默认 | 说明 |
|---|---|---|
FALKORDB_HOST | localhost | FalkorDB 服务器主机 |
FALKORDB_PORT | 6379 | FalkorDB 服务器端口 |
FALKORDB_PASSWORD | (无) | FalkorDB 密码 |
FALKORDB_GRAPH_NAME | cavdax_core_graph | 要使用的图表 |
CAVDAX_MODE | auto | auto, (中文(简体) ), live 或者说 simulation |
CAVDAX_REPO_ROOT | 当前目录 | 目录文件写入仅限于 |
CAVDAX_SERVER_URL | (无) | CI/CD 门回落的远程 CAVDAX 服务器 URL |
CAVDAX_API_KEY | (无) | 用于认证远程决策检查的 API 代号 |
许可证
Apache-2.0 — — — CAVDAX 作者和贡献者