# @cavdax/mcp-server 中文文档

规范地址：https://npmcn.com/package/%40cavdax/mcp-server/

版本：1\.2\.8
npm 元数据更新时间：2026-11-06T18:17:26.089Z
中文译文更新时间：2026-11-09T19:02:18.906Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40cavdax/mcp-server
原文对照：https://npmcn.com/package/%40cavdax/mcp-server/?lang=original
项目主页：https://cavdax.sahnirmaan.live/
源码仓库：https://github.com/CAVDAX/CAVDAX

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：159 kB，19 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=18\.0\.0
- 运行依赖：2 个
- 首次发布：2026-10-20T11:18:56.771Z
- 最新版本发布：2026-11-06T18:17:25.705Z
- 近 30 天下载量：1832（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 11 个）

## 中文简介

CAVDAX 由 FalkorDB GraphBLAS 支持的封闭模式上下文协议(MCP)服务器

## 安装

```sh
npm install @cavdax/mcp-server
```

也可以使用：`pnpm add @cavdax/mcp-server`、`yarn add @cavdax/mcp-server`、`bun add @cavdax/mcp-server`

## README

# @ cavdax/ mcp- 服务器

> **加利福尼亚州** - 背景行动和经核实的决定 自主评估  
> 附录 MCP 由 FalkorDB GraphBLAS 支持的服务器

Blocks AI 编码代理从基于 Stale 或被取代的架构决定写入代码. 执行 [示范背景协议](https://spec.modelcontextprotocol.io/) `2024-11-05` 与 Cursor 、 Claude Code 和 Claude Desktop 进行零配置集成.

* * *

## 快速启动

### 光标( 项目级别) `.cursor/mcp.json`(中文(简体) )

```json
{
  "mcpServers": {
    "cavdax": {
      "command": "npx",
      "args": ["-y", "@cavdax/mcp-server"]
    }
  }
}
```

### Claude 代码 CLI

```bash
claude mcp add cavdax npx -y @cavdax/mcp-server
```

### Claude 桌面 (`claude_desktop_config.json`(中文(简体) )

```json
{
  "mcpServers": {
    "cavdax": {
      "command": "npx",
      "args": ["-y", "@cavdax/mcp-server"]
    }
  }
}
```

### 主机 Entertainment SSE (Cursor / 任何 SSE 有能力的客户端)

```json
{
  "mcpServers": {
    "cavdax-cloud": {
      "url": "https://cavdax.sahnirmaan.live/api/mcp/sse",
      "transport": "sse"
    }
  }
}
```

* * *

## CLI 命令

```bash
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或代理 `npx` stdio过程得到自己的锁表,所以这些过程不会看到对方的锁. 对于跨不同客户端的多代理安全,将其指向一个共享服务器,如主机SSE端点.

* * *

## FalkorDB 设置( 本地)

```bash
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 作者和贡献者

## 常见问题

### @cavdax/mcp-server 是什么？

CAVDAX 由 FalkorDB GraphBLAS 支持的封闭模式上下文协议\(MCP\)服务器

### 如何安装 @cavdax/mcp-server？

在项目目录运行 npm install @cavdax/mcp-server，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 cavdax、cavdax-mcp，可以用 npx cavdax 直接运行。

### @cavdax/mcp-server 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/cavdax\_\_mcp-server 是否存在。

### @cavdax/mcp-server 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @cavdax/mcp-server 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @cavdax/mcp-server 可以商用吗？

@cavdax/mcp-server 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @cavdax/mcp-server 的下载量有多少？

根据 npm 官方下载统计，@cavdax/mcp-server 在 2026/10/09 – 2026/11/07 这 30 天内被下载 1,832 次，日均约 61 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @cavdax/mcp-server 还在维护吗？

最新版本 1\.2\.8 发布于 2026/11/07（3 天前）；至今共发布 11 个版本，其中过去 12 个月发布了 11 个；首次发布于 2026/10/20。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。