
cMCP: 機密MCPゲートウェイ。MCPツール呼び出しに対するハードウェア認証によるポリシー強制。
<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日のConfidential Computing Summitで発表されました。v1.0までに破壊的変更が含まれる可能性があります。現在提供されている機能とロードマップ上の機能の正確な内容については[STATUS.md](https://github.com/agentrust-io/cmcp/blob/main/STATUS.md)を参照してください。
**cMCP (Confidential MCP Runtime) は、AIエージェントが行うすべてのツール呼び出しを、あなたが記述したルールに照らして検査し、エージェントが改ざんできない隔離されたハードウェア上で実行できるオープンソースのゲートウェイです。** AIエージェントは、通常MCP (Model Context Protocol) を介してツール呼び出しと呼ばれるリクエストを送信することで、ツール (データベース、CRM、メール、内部API) を利用します。cMCPはそれらの呼び出しの経路上に位置し、各呼び出しをあなたのルール (Cedarポリシー言語で記述) に照らして検査し、ルールが禁止するものをブロックします。cMCPはTEE (トラステッド実行環境: マシンの所有者からさえもプログラムのメモリを隔離して保持するハードウェア) 内で実行でき、そこで管理対象のエージェントはcMCPに到達できません。各セッションは署名付きレシートであるTRACE Claimで終了し、ゲートウェイを運用した人物を信頼することなく誰でも検証できます。レシートは、ゲートウェイがTEE内で実行される場合はハードウェアレポートに裏付けられ、ソフトウェアモードでは署名のみ (ハードウェア証明なし) となります。これらの用語に馴染みがない場合は、[用語の平易な解説](https://agentrust-io.com/#plain-terms)を参照してください。
> **TL;DR:** エージェントをcMCP Gatewayに向けてください。すべてのツール呼び出しをあなたのCedarルールに照らして検査し、ルールが拒否するものをブロックまたはリダクト (伏字化) し、誰かが改ざんしたかどうかを示す署名付きレシートを提供します。`pip install cmcp-runtime`を実行し、特別なハードウェアを必要とせず、任意のコンピューター上でソフトウェアモードで開始できます。
あなたのエージェントはSnowflake、Salesforce、十数のAPIを呼び出します。それらの呼び出しの一つで顧客データが漏洩するのを何が防ぐのでしょうか? 規制当局から問われた場合、漏洩していないことを証明できるでしょうか?
---
## 課題
エージェントがツールを呼び出します。ポリシーエンジンが許可を出します。ツール呼び出しが通過します。
これらのいずれも、ポリシーエンジン自体が侵害されていないことを証明するものではありません。ソフトウェアのみのMCPガバナンスでは、以下を保証できません:
- ディスク上のCedarポリシーが、実際に実行されたものであること。悪意のある管理者は承認後にバンドルを差し替えられます。ハッシュチェックは、その管理者が制御する同じOS内で実行されます。
- 許可/拒否の判定がメモリ内で反転されていないこと。評価器のサプライチェーンCVEは、攻撃者と同じアドレス空間で実行されます。
- 監査ログが実際に起きたことを反映していること。ソフトウェア署名鍵を保持する者は誰でも、事後に有効な監査チェーンを再構築できます。
ツール呼び出しを統治するコントロールプレーンは、それが統治するプロセスから到達できない場所で実行されなければなりません。
MCPツール呼び出しに対するハードウェア認証済みポリシー適用。すべてのツール呼び出しはインターセプトされ、Cedarポリシーバンドルに対して評価され、Trusted Execution Environment(TEE)内で動作するポリシーエンジンによって適用されます。単一のツール呼び出しを処理する前に、ゲートウェイはインストールされたコード、ポリシーバンドル、および設定をハードウェア認証レポートに測定し、バンドルが再ロードされるたびに再認証を行います。
ハードウェアデプロイメントでは、cMCP RuntimeはTEE内でツール呼び出しペイロードを処理します。ホストおよび接続プロバイダーが読み取れる内容は、egressポリシーにも依存し、アップストリームのツールサーバーは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` はベアラートークンの要件を意図的にスキップするため、素早く試すことができますが、デフォルトのバインドは依然として `0.0.0.0:8443` です。0.3.0 では、この組み合わせによりマシン上のすべてのインターフェースで認証なしのゲートウェイが起動していました。0.4.0 からは拒否されます。トークンなしの開発モードはループバックアドレスにのみバインドでき、非ループバックへのバインドには `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/)では、ノートPC上で約10分、ハードウェアもサインアップも不要で同じ道筋をたどれます。インストールし、Cedarの`forbid`ルールを1つ書き、ツール呼び出しが上流に到達する前に403 `POLICY_DENY`を返すのを確認し、その後、署名済みレシートを検証します。
完全なウォークスルーについては[docs/quickstart.md](https://github.com/agentrust-io/cmcp/blob/main/docs/quickstart.md)を参照してください:Cedarポリシー、ツールカタログ、最初のTRACE Claim、そして検証(ハードウェアTEEは不要)。
---
## 仕組み
1. エージェントは、MCPサーバーに直接ではなく、すべてのツール呼び出しをcMCP Gatewayに送信します。
2. 起動時、トラフィックを処理する前に、ゲートウェイはインストールされたコード、Cedarポリシーバンドル、および設定を測定します。SEV-SNP、TDX、Azure CVMではダイジェストが`report_data`にバインドされ、TPMティアでは認定されたNVインデックスに拡張されます。ポリシーのリロードは新たなアテステーションをトリガーします。
3. 受信する各ツール呼び出しは、TEE内で実行されるCedarポリシーエンジンによって評価されます。結果はallow、deny、またはredactです。呼び出しとその決定は、ハードウェアで封印された監査チェーンに追加されます。
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クォート |
| `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` を設定してください。
---
## 設定
`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` | すべての受信リクエストにこのベアラートークンを要求する |
---
## 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 を検証する (署名、スキーマ、鮮度、監査チェーン、固定ハッシュ、トラストアンカー) |
---
## TRACE Claims
`GatewayClaim` は、監査人、規制当局、または下流の検証者に渡される証明の単位です。セッションごと (または呼び出しごと、設定可能) に生成され、TEE の外に出ることのない鍵で署名されます。
| フィールド | 説明 |
|---|---|
| `trace.eat_profile` | EAT プロファイル URI: `tag:agentrust-io.com,2026:trace-v0.2` |
| `trace.runtime` | エンクレーブ起動時に記録された 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 にバインドされた鍵に対して、ポリシーバンドルのハッシュを承認済みの値に対して、監査チェーンを内部整合性についてチェックします。
規範的なスキーマは [`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 内のポリシー決定ポイント。ワークロード ID への暗黙の信頼を排除 |
| 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 プロファイルを識別する |
---
## セキュリティ
| ツール | チェック内容 |
|---|---|
| ruff | すべての PR でスタイルとインポートのリンティング |
| bandit | すべての PR で Python セキュリティリンティング |
| 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) を参照してください。APM ペイロードキャプチャ、実行時設定インジェクション、およびフェーズ 1 では解消されない P4.1 サプライチェーン (タイポスクワッティング) の残余リスクを含む、明示的なスコープ境界については [LIMITATIONS.md](https://github.com/agentrust-io/cmcp/blob/main/LIMITATIONS.md) を参照してください。
---
## ドキュメント
| ページ | 説明 |
|---|---|
| [docs/quickstart.md](https://github.com/agentrust-io/cmcp/blob/main/docs/quickstart.md) | ゼロから最初の TRACE Claim まで30分以内 |
| [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 プロバイダーごとのレイテンシとスループットのベンチマーク |
---
## FAQ
### cMCP とは何ですか?
cMCP (Confidential MCP Runtime) は、ハードウェアの Trusted Execution Environment 内で MCP ツール呼び出しポリシーを強制するオープンソースのゲートウェイです。各ツール呼び出しをインターセプトし、Cedar ポリシーバンドルに対して評価し、その決定 (許可、拒否、または秘匿化) を強制し、呼び出しをハードウェアで封印された監査チェーンに記録します。
### cMCP はソフトウェアのみの MCP ガバナンスとどう違うのですか?
ソフトウェアのみのガバナンスでは、ポリシーエンジンがオペレーターやサプライチェーンの CVE が到達しうる同じ OS 上で動作するため、実行されたポリシーが承認済みのものであることや、決定がメモリ内で改ざんされていないことを証明できません。cMCP はポリシーエンジンを TEE 内で実行し、1件の呼び出しを処理する前にそのコードと 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 をサポートし、NVIDIA GPU のコンフィデンシャルコンピューティングは v0.2 で計画されています。自動検出の順序は Azure コンフィデンシャル VM、次に 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) を参照してください。