<p align="center">
<img src="https://raw.githubusercontent.com/agentrust-io/cmcp/HEAD/docs/assets/icon.svg" width="96" height="96" alt="cMCP"/>
</p>
# cMCP:机密 MCP 运行时
社区动态与贡献者亮点:[AgenTrust on LinkedIn](https://www.linkedin.com/company/agentrust-io/)。
### 在 TEE 内强制执行 MCP 工具策略,使其所管控的智能体无法触及
<p align="center">
<a href="https://cmcp.agentrust-io.com">
<img src="https://img.shields.io/badge/Documentation-cmcp.agentrust--io.com-7c3aed?style=for-the-badge" alt="Documentation" height="36">
</a>
</p>
<p align="center">
<strong>
<a href="#quick-start">快速开始</a> ·
<a href="#how-it-works">架构</a> ·
<a href="#configuration">配置</a> ·
<a href="#cli-reference">CLI</a> ·
<a href="https://github.com/agentrust-io/cmcp/blob/main/CHANGELOG.md">更新日志</a>
</strong>
</p>
[](https://github.com/agentrust-io/cmcp/actions/workflows/ci.yml) [](LICENSE) [](https://pypi.org/project/cmcp-runtime/) [](https://scorecard.dev/viewer/?uri=github.com/agentrust-io/cmcp) [](https://discord.gg/grgzFEHgkj)
> **开发者预览版** - 于 2026 年 6 月 23 日在机密计算峰会上发布。在 v1.0 之前可能会有破坏性变更。请参阅 [STATUS.md](https://github.com/agentrust-io/cmcp/blob/main/STATUS.md) 了解当前已交付的内容与路线图上的内容。
**cMCP(机密 MCP 运行时)是一个开源网关,它会根据你编写的规则检查 AI 智能体发起的每一次工具调用,并且可以运行在智能体无法篡改的封闭硬件上。** AI 智能体通过发送称为工具调用的请求来使用工具(数据库、CRM、电子邮件、内部 API),通常经由 MCP(模型上下文协议)进行。cMCP 位于这些调用的路径上,根据你的规则(使用 Cedar 策略语言编写)检查每一次调用,并阻止规则禁止的调用。它可以运行在 TEE(可信执行环境:即使对机器所有者也能将程序内存封闭隔离的硬件)内,其所管控的智能体无法触及。每个会话结束时都会生成一份签名收据,即 TRACE Claim,任何人都可以在不信任网关运行者的情况下进行验证。当网关在 TEE 中运行时,该收据由硬件报告背书;在软件模式下则仅签名(无硬件证明)。不熟悉这些术语?请参阅[通俗易懂的术语说明](https://agentrust-io.com/#plain-terms)。
> **简而言之:** 将你的智能体指向 cMCP Gateway。它会根据你的 Cedar 规则检查每一次工具调用,阻止或脱敏(涂黑)规则拒绝的内容,并为你提供一份签名收据,显示是否有人篡改过它。运行 `pip install cmcp-runtime`,即可在任何计算机上以软件模式启动;无需特殊硬件。
你的智能体调用 Snowflake、Salesforce、十几个 API。是什么阻止它在这些调用中泄露客户数据?如果监管机构问起,你能证明它没有泄露吗?
---
## 问题所在
智能体调用一个工具。策略引擎说允许。工具调用通过。
这一切都无法证明策略引擎本身没有被攻破。仅靠软件的 MCP 治理无法保证:
- 磁盘上的 Cedar 策略就是实际运行的那一份。恶意管理员可以在审批后替换策略包;哈希校验运行在管理员控制的同一操作系统内。
- 允许/拒绝决策没有在内存中被翻转。评估器中的供应链 CVE 与攻击者运行在同一地址空间。
- 审计日志反映了实际发生的情况。任何持有软件签名密钥的一方都可以事后重建一条有效的审计链。
管控工具调用的控制平面必须运行在其所管控的进程无法触及的地方。
面向 MCP 工具调用的硬件证明策略执行。每一次工具调用都会被拦截,依据 Cedar 策略包进行评估,并由运行在可信执行环境(TEE)内的策略引擎强制执行。在提供任何一次工具调用服务之前,网关会将其已安装的代码、策略包和配置度量到硬件证明报告中,并在策略包重新加载时重新进行证明。
在硬件部署中,cMCP Runtime 在 TEE 内处理工具调用负载。主机和连接提供商能够读取的内容还取决于出口策略,而上游工具服务器是位于 TEE 之外的独立组件。软件模式(`CMCP_DEV_MODE`)不提供硬件隔离。[LIMITATIONS.md](https://github.com/agentrust-io/cmcp/blob/main/LIMITATIONS.md) 列出了 cMCP 无法防范的内容。
---
## 快速开始
```bash
pip install cmcp-runtime
```
创建 `cmcp-config.yaml`:
```yaml
attestation:
provider: auto
enforcement_mode: advisory # advisory eases first-run tuning; the default is `enforcing`
listen_addr: "127.0.0.1:8443" # pin loopback: dev mode runs without a bearer token
policy_bundle_path: ./policies/
catalog_path: ./catalog.json
```
`listen_addr` 在这里不是可选项。`CMCP_DEV_MODE=1` 会刻意跳过 bearer token 要求,以便你快速试用,而默认绑定仍然是 `0.0.0.0:8443`。在 0.3.0 上,这种组合会在你机器的每个网络接口上启动一个未认证的网关。从 0.4.0 起,这种配置会被拒绝:无 token 的开发模式只能绑定回环地址,而非回环绑定需要 `CMCP_BEARER_TOKEN`。显式固定 `listen_addr`,配置在两者上都是正确的。
启动网关:
```bash
CMCP_DEV_MODE=1 cmcp start --config cmcp-config.yaml
```
发起工具调用:
```bash
curl -X POST http://localhost:8443/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"salesforce.contacts","arguments":{"query":"Acme Corp"},"_cmcp":{"session_id":"s1","workflow_id":"demo-agent"}}}'
```
想要引导式版本?[agentrust-io.com/quickstart](https://agentrust-io.com/quickstart/) 在笔记本电脑上大约十分钟就能走完同样的流程,无需硬件,也无需注册:安装、编写一条 Cedar `forbid` 规则、观察一次工具调用在到达上游之前返回 403 `POLICY_DENY`,然后验证签名回执。
完整演练请参见 [docs/quickstart.md](https://github.com/agentrust-io/cmcp/blob/main/docs/quickstart.md):Cedar 策略、工具目录、首个 TRACE Claim 以及验证(无需硬件 TEE)。
---
## 工作原理
1. 智能体将每次工具调用发送到 cMCP Gateway,而不是直接发送到 MCP 服务器。
2. 在启动时、开始处理流量之前,网关会度量其已安装的代码、Cedar 策略包和配置。在 SEV-SNP、TDX 和 Azure CVM 上,摘要会被绑定到 `report_data` 中;在 TPM 层级上,它会被扩展到经过认证的 NV 索引中。策略重新加载会触发一次新的证明。
3. 每个传入的工具调用都由运行在 TEE 内的 Cedar 策略引擎进行评估。结果为允许、拒绝或脱敏。该调用及其决策会被追加到硬件密封的审计链中。
4. 在会话结束时,网关会生成一个 TRACE Claim:一个经过签名、由硬件证明的工件,记录哪些工具运行过、每次调用由哪条策略决定,以及完整的审计链。验证者无需信任运营方即可检查这一点。
```
Agent -> cMCP Runtime -> Cedar Policy Engine (TEE) -> Tool
|
GatewayClaim (TRACE Profile)
+-- trace.eat_profile
+-- trace.runtime.platform + measurement
+-- trace.policy.bundle_hash
+-- trace.cnf.jwk (Ed25519 confirmation key)
+-- gateway.audit_chain (root/tip/length)
+-- signature (Ed25519 over canonical JSON)
```
## 硬件提供程序
| 提供程序 | 平台 | 保证级别 | 说明 |
|---|---|---|---|
| `tpm` | TPM 2.0 / vTPM(Azure、AWS、GCP Trusted Launch) | 中 | 本地 TPM quote |
| `sev-snp` | AMD SEV-SNP(Azure DCasv5、AWS C6a Nitro) | 高 | AMD KDS |
| `tdx` | Intel TDX(Azure DCedsv5、GCP C3) | 高 | Intel PCS |
| `gpu-cc` _(v0.2)_ | NVIDIA H100/H200/Blackwell(CC 模式) | 高 | NVIDIA Remote Attestation Service (NRAS) |
提供程序自动检测探测顺序:`azure-cvm -> tpm -> sev-snp -> tdx`。将选择第一个 `detect()` 成功的提供程序。如果未检测到任何硬件提供程序,网关仅在 `CMCP_DEV_MODE=1`(一种非认证的纯软件回退模式)下启动,否则拒绝启动。
```python
from cmcp_runtime.config import TEEProvider
# Auto-detect (default)
# attestation.provider: auto -> azure-cvm -> tpm -> sev-snp -> tdx
# (software-only is used only under CMCP_DEV_MODE=1)
# Explicit hardware selection
# attestation.provider: sev-snp
```
## 执行模式
| 模式 | 行为 | 使用场景 |
|---|---|---|
| `enforcing` | 策略拒绝时返回 HTTP 403;调用不会被转发 | 生产环境 |
| `advisory` | 策略拒绝会被记录;调用继续执行 | 首次部署、策略调优 |
| `silent` | 策略会被评估,但不记录也不阻止任何内容 | 基线建立 |
默认值为 `enforcing`。在 `cmcp-config.yaml` 中设置 `enforcement_mode: advisory` 以使用 advisory 模式。
---
## 配置
`cmcp-config.yaml` 完整参考:
```yaml
attestation:
provider: auto # auto | tpm | sev-snp | tdx | software-only
enforcement_mode: enforcing # enforcing | advisory | silent
validity_seconds: 86400 # attestation freshness window (default: 24 hours)
staleness_policy: fail_closed # fail_closed | warn_only
expected_measurement: ~ # pin a specific PCR/measurement (optional)
policy_bundle_path: policies/ # directory containing .cedar files and manifest.json
catalog_path: catalog.json # approved tool catalog
listen_addr: "127.0.0.1:8443" # tokenless dev mode is loopback-only; set CMCP_BEARER_TOKEN before binding wider
max_response_size_bytes: 2097152 # 2 MB default
policy_reload_interval_seconds: 0 # >0 with a pinned CMCP_POLICY_HASH refuses to start, see docs/spec/policy-hot-reload.md
```
环境变量:
| 变量 | 作用 |
|---|---|
| `CMCP_DEV_MODE=1` | 使用仅软件的 TEE 提供程序;无需硬件 |
| `CMCP_BEARER_TOKEN` | 要求所有入站请求携带此 bearer token |
---
## CLI 参考
| 命令 | 标志 | 描述 |
|---|---|---|
| `cmcp start` | `--config PATH`(必需) | 启动网关 |
| `cmcp validate-config` | `--config PATH`(必需) | 在不启动的情况下验证 `cmcp-config.yaml` |
| `cmcp validate-bundle` | `--bundle-path PATH`(必需)、`--expected-hash sha256:<hex>`(必需) | 在部署前验证 Cedar 包哈希 |
| `cmcp verify` | `CLAIM_FILE`(必需);`--policy-hash`、`--catalog-hash`、`--max-age`、`--trusted-key`、`--trusted-tpm-ca`、`--audit-bundle`、`--agent-manifest`、`--agent-manifest-trust-anchor` | 验证已签名的 TRACE Claim(签名、schema、新鲜度、审计链、固定哈希和信任锚) |
---
## TRACE Claims
`GatewayClaim` 是交付给审计员、监管机构或下游验证者的证明单元。它按会话(或按调用,可配置)生成,并使用永不离开 TEE 的密钥签名。
| 字段 | 描述 |
|---|---|
| `trace.eat_profile` | EAT profile URI:`tag:agentrust-io.com,2026:trace-v0.2` |
| `trace.runtime` | 在 enclave 启动时记录的 TEE 平台和硬件度量 |
| `trace.policy.bundle_hash` | 启动时加载的 Cedar 包的 SHA-256;更改任何策略文件都会改变此值 |
| `trace.cnf.jwk` | 绑定到 TEE 签名密钥的 Ed25519 公钥 |
| `trace.tool_transcript` | 从审计链派生的按调用视图:`hash`(绑定到审计链尖端)、`call_count` 以及保护隐私的 `entries`(工具名称、数据类别、决策) |
| `gateway.audit_chain` | 哈希链式审计日志根和尖端;无需重放单个条目即可验证 |
| `signature` | 对完整 claim 正文的规范 JSON(RFC 8785)的 Ed25519 签名 |
(此表是最常用字段的摘要。)
使用 `cmcp_verify` 库进行验证不需要信任操作员。验证者会对照 TEE 绑定的密钥检查签名,对照批准的值检查策略包哈希,并检查审计链的内部一致性。
规范 schema 为 [`schemas/trace-claim.schema.json`](https://github.com/agentrust-io/cmcp/blob/main/schemas/trace-claim.schema.json),[docs/quickstart.md](https://github.com/agentrust-io/cmcp/blob/main/docs/quickstart.md) 展示了一个完整示例。有关完整的验证协议,请参阅 [docs/spec/verification-library.md](https://github.com/agentrust-io/cmcp/blob/main/docs/spec/verification-library.md) 和 [TRACE 规范](https://trace.agentrust-io.com)。
---
## 标准对齐
| 标准 | 覆盖范围 |
|---|---|
| OWASP Agentic AI Top 10 | MCP10(通过工具调用导致的数据泄露)、MCP02(未经批准的工具)、MCP08(可证明的治理)、MCP04(供应链) |
| NIST SP 800-207 | TEE 内的策略决策点;不隐式信任工作负载身份 |
| EU AI Act Art. 12, 15 | 按决策的审计记录(Art. 12);TEE 支持的网络安全控制(Art. 15) |
| DORA Art. 9 | 证明链;通过 `gateway.audit_chain` 保留审计日志 |
| RATS/EAT RFC 9711 | `GatewayClaim` 是一个 EAT;`eat_profile` 字段标识 TRACE profile |
---
## 安全
| 工具 | 检查内容 |
|---|---|
| ruff | 每个 PR 上的风格和导入 linting |
| bandit | 每个 PR 上的 Python 安全 linting |
| pip-audit | 每个 PR 上的依赖漏洞扫描 |
| mypy | 每个 PR 上的静态类型检查 |
| CodeQL | Python SAST,security-extended 查询,每周 |
| OpenSSF Scorecard | 每周评分,SARIF 上传 |
有关漏洞报告和响应 SLA,请参阅 [SECURITY.md](https://github.com/agentrust-io/cmcp/blob/main/SECURITY.md)。有关明确的适用范围边界,请参阅 [LIMITATIONS.md](https://github.com/agentrust-io/cmcp/blob/main/LIMITATIONS.md),包括 APM 负载捕获、运行时配置注入以及 Phase 1 未关闭的 P4.1 供应链(typosquat)的残余风险。
---
## 文档
| 页面 | 描述 |
|---|---|
| [docs/quickstart.md](https://github.com/agentrust-io/cmcp/blob/main/docs/quickstart.md) | 从零开始,在 30 分钟内生成第一个 TRACE Claim |
| [docs/configuration.md](https://github.com/agentrust-io/cmcp/blob/main/docs/configuration.md) | 完整的配置参考,包含所有字段和默认值 |
| [docs/confinement.md](https://github.com/agentrust-io/cmcp/blob/main/docs/confinement.md) | 实验性 Linux 代理沙箱、绕过测试与信任假设 |
| [docs/SPEC.md](https://github.com/agentrust-io/cmcp/blob/main/docs/SPEC.md) | 产品规范:问题分类、架构、覆盖矩阵 |
| [docs/spec/threat-model.md](https://github.com/agentrust-io/cmcp/blob/main/docs/spec/threat-model.md) | STRIDE 分析、对手模型、残余风险 |
| [docs/spec/cedar-policy.md](https://github.com/agentrust-io/cmcp/blob/main/docs/spec/cedar-policy.md) | Cedar 策略语言参考与模式 |
| [docs/testing/benchmarks.md](https://github.com/agentrust-io/cmcp/blob/main/docs/testing/benchmarks.md) | 各 TEE 提供方的延迟与吞吐量基准测试 |
---
## 常见问题
### 什么是 cMCP?
cMCP(Confidential MCP Runtime)是一个开源网关,在硬件可信执行环境(TEE)内强制执行 MCP 工具调用策略。它拦截每一次工具调用,依据 Cedar 策略包对其进行评估,执行决策(允许、拒绝或脱敏),并将该调用记录到由硬件密封的审计链中。
### cMCP 与纯软件实现的 MCP 治理有何不同?
纯软件治理在运维人员或供应链 CVE 能够触及的同一操作系统中运行策略引擎,因此无法证明实际运行的策略是已批准的那一个,也无法证明决策未在内存中被篡改。cMCP 在 TEE 内运行策略引擎,并在处理任何一次调用之前,将其代码和 Cedar 策略包度量进硬件证明报告,因此它所治理的进程无法触及控制平面。
### 试用它需要特殊硬件吗?
不需要。设置 `CMCP_DEV_MODE=1` 即可使用纯软件 TEE 提供方,无需硬件 TEE 就能运行完整的快速入门。硬件提供方(TPM、AMD SEV-SNP、Intel TDX)用于生产环境。
### 什么是 TRACE Claim?
TRACE Claim(即 `GatewayClaim`)是每个会话生成的、经过签名的硬件证明产物。它记录运行了哪些工具、每次调用由哪条策略决定、Cedar 策略包哈希以及审计链,并使用永不离开 TEE 的 Ed25519 密钥进行签名。验证者可使用 `cmcp_verify` 库对其进行校验,而无需信任运维方。
### 支持哪些 TEE 提供方?
TPM 2.0 / vTPM、AMD SEV-SNP 和 Intel TDX,并计划在 v0.2 中支持 NVIDIA GPU 机密计算。自动检测顺序为:Azure 机密虚拟机,然后是 TPM 2.0 / vTPM,然后是 AMD SEV-SNP,最后是 Intel TDX;纯软件提供方仅在 CMCP_DEV_MODE=1 下使用。
### cMCP 采用什么许可证?
MIT。
---
## 贡献
[CONTRIBUTING.md](https://github.com/agentrust-io/cmcp/blob/main/CONTRIBUTING.md) · [GOVERNANCE.md](https://github.com/agentrust-io/cmcp/blob/main/GOVERNANCE.md) · [Discussions](https://github.com/orgs/agentrust-io/discussions)
在 [Discord](https://discord.gg/grgzFEHgkj) 上加入社区。
在生产环境中使用 cMCP?请将你的组织添加到 [ADOPTERS.md](https://github.com/agentrust-io/cmcp/blob/main/ADOPTERS.md)。
---
## 许可证
MIT - 参见 [LICENSE](https://github.com/agentrust-io/cmcp/blob/main/LICENSE)。