使用说明
哨兵MCP
███████╗███████╗███╗ ██╗████████╗██╗███╗ ██╗███████╗██╗
██╔════╝██╔════╝████╗ ██║╚══██╔══╝██║████╗ ██║██╔════╝██║
███████╗█████╗ ██╔██╗ ██║ ██║ ██║██╔██╗ ██║█████╗ ██║
╚════██║██╔══╝ ██║╚██╗██║ ██║ ██║██║╚██╗██║██╔══╝ ██║
███████║███████╗██║ ╚████║ ██║ ██║██║ ╚████║███████╗███████╗
╚══════╝╚══════╝╚═╝ ╚═══╝ ╚═╝ ╚═╝╚═╝ ╚═══╝╚══════╝╚══════╝
MCP Governance Runtime • Verifiable Policy Enforcement • Provenance by Design
MCP/A2A生态系统中代理工具使用的治理控制平面。
为什么选择Sentinel MCP
AI代理可以以机器速度执行工具；故障和误用也会随着机器速度的增加而增加。Sentinel MCP在代理和工具之间添加了一个可审计的决策层，因此每次调用都可以被授权、解释、重放和验证。
核心价值观：
- 确定性政策执行（OPA/Rego作为记录系统）
- 人为审批因高风险行为而中断
- 具有强优先级保证的停止开关控制
- 带有Sigstore就绪透明度链接的签名来源
- 事件来源的证据，用于事后调查和合规
一分钟架构
flowchart LR
AG["Agent Runtime"] --> AD["Adapter Layer (MCP + A2A)"]
AD --> CP["Sentinel Control Plane v2"]
CP --> PE["OPA/Rego"]
CP --> EV["Event Ledger"]
CP --> PR["Provenance (DSSE + Sigstore)"]
CP --> TOOLS["Tools / MCP Servers"]
产品故事板
选择你的道路
- 非技术概述： 执行摘要
- 技术深潜： 架构v2
- 前端系统指南： 前端任务控制
- 快速入职： 设置和部署
- 实践演练： 演示指南
- 操作响应： Runbook
- 用户体验操作节奏： 用户体验操作手册
- 安全态势： 安全与合规
- API详细信息： v2 API参考
- 100/100执行跟踪器： 前端主跟踪器
快速入门（v2，本地）
git clone https://github.com/jlov7/Sentinel-MCP.git
cd Sentinel-MCP
# Python + legacy stack deps
make install
# Rust v2 control plane
cd apps/control-plane-v2
cargo run
运行任务控制UI：
cd apps/admin-console
npm install
NEXT_PUBLIC_CONTROL_PLANE_URL=http://localhost:8082 npm run dev
- UI：
http://localhost:3000 - v2运行状况：
http://localhost:8082/healthz
可验证的治理：端到端
v2中的决策可追溯性：
POST /v2/decisions/authorize评估政策+风险- 允许决策自动生成签名证明（如果证明持久性失败，则关闭失败）
- 证据回放可通过
GET /v2/evidence/{trace_id} - 通过API和独立CLI进行认证验证
独立验证器示例：
cd apps/control-plane-v2
cargo run --bin attestation_verify -- \
--mode local \
--secret "$SENTINEL_V2_DSSE_SIGNING_SECRET" \
--envelope /path/to/envelope.json
质量门（预发布）
运行满闸：
make v2-release-gate
这运行：
- 锈蚀格式/棉绒/测试
- 性能/安全回归套件
- 独立认证验证者测试
- 管理控制台lint/test/build
- 根Python pytest套件
- 机器可读报告输出
apps/control-plane-v2/eval/reports/latest.json
存储库映射
apps/
control-plane/ # v1 FastAPI baseline
control-plane-v2/ # v2 Rust governance runtime
admin-console/ # Mission control UI (Next.js)
packages/
policy_engine/ # OPA policy client + helpers
provenance/ # Provenance helpers (v1 path)
docs/
governance/ # Non-technical and leadership docs
technical/ # Architecture, setup, testing
operations/ # Security + incident runbooks
reference/ # API and release-gate references
assets/ # Diagrams, screenshots, illustrations
贡献标准
- 保持策略更改的测试支持和可审查性。
- 保持决策语义的确定性，并明确地进行原因编码。
- 使文档与行为更改保持同步（API、证据字段、门条件）。
看 贡献.md.
免责声明
此存储库是独立创建的个人研发项目，与我的雇主无关，也不代表我的雇主的观点、系统或路线图。
