acp-mcp-server

ACP Governance MCP Server

Model Context Protocol 服务，让 Claude、ChatGPT、Cursor、Lovable 和任何 MCP 客户端都能根据 Agentic Control Plane 治理规则检查工具调用——包括策略决策、速率限制、审计日志和身份归属。

一句话概括： 在 AI Agent 执行敏感工具前，它会询问 ACP 是否允许此次调用。ACP 会答复允许、拒绝或要求确认，并写入一条可归属到 Agent 背后人类用户的审计记录。

提供的功能

可通过 MCP 调用的两个工具：

工具	功能
acp_check	针对特定调用回答“是否允许此次调用？”，适用于明确提问或执行前规划。如果在运行环境中安装了 ACP hooks，工具调用就已自动纳入治理，无需针对每个工具单独调用此工具。返回 allow / deny / ask 及原因。
acp_status	验证连接和你的工作区身份。

这就是全部功能。其他所有内容——策略、审计日志、范围交集、委派链——都在 api.agenticcontrolplane.com 的服务端运行。此 MCP 服务只是桥接层。

安装（托管版 — 推荐）

此服务托管在 https://mcp.agenticcontrolplane.com/mcp。在你的 MCP 客户端中将其添加为连接器：

Claude Desktop / Claude.ai 连接器：

URL: https://mcp.agenticcontrolplane.com/mcp
Auth: OAuth (sign in with Google through ACP)

ChatGPT、Cursor、Lovable、Cline： 使用相同的 URL 和 OAuth 流程。大多数客户端都提供一键式“添加 MCP Server”界面。

编程客户端（你自己的 Agent 代码）：

POST https://mcp.agenticcontrolplane.com/mcp
Authorization: Bearer gsk_<your-acp-api-key>
Content-Type: application/json

你需要一个 ACP 工作区。免费层级提供无限量的工具调用日志记录——在 cloud.agenticcontrolplane.com/login 注册。

安装（自托管）

如果你想自行运行桥接服务——用于气隙部署，或连接到自托管的 ACP 网关——请克隆并运行：

git clone https://github.com/agentic-control-plane/acp-mcp-server
cd acp-mcp-server
npm install
npm run build

# Point at the ACP API (default: https://api.agenticcontrolplane.com)
export ACP_API_BASE=https://your-acp-gateway.example.com

# Optional: service-level API key for OAuth users (ChatGPT, Claude.ai)
# whose JWTs aren't directly usable as ACP tokens
export ACP_SERVICE_KEY=gsk_workspace_...

npm start
# → MCP endpoint: POST http://0.0.0.0:3000/mcp
# → OAuth discovery: GET /.well-known/oauth-protected-resource

该桥接服务通过可流式传输的 HTTP MCP 与 ACP 的 /govern/tool-use 端点通信，并将请求转发给它。

工作方式

your AI client            this MCP server          ACP gateway
─────────────            ─────────────────         ───────────
Claude / ChatGPT  ──►  mcp.agenticcontrolplane  ──►  api.agenticcontrolplane
Cursor / Lovable    POST /mcp (acp_check)         POST /govern/tool-use
                                                      ↓
                                                   policy + audit + identity
                                                      ↓
                                                   allow / deny / ask

每次调用都会写入一条审计记录，并归属到 OAuth 会话背后的人类身份——这样，你就能在一个工作区中获得团队使用的所有 MCP 客户端上每一次受治理工具调用的完整日志。

身份验证模型

此服务支持两种身份验证方式：

1. OAuth（推荐用于由人类驱动的客户端） — Claude.ai、ChatGPT 等通过 ACP 的身份提供方完成 OAuth 流程；生成的 Auth0 JWT 用于识别用户。桥接服务使用 ACP_SERVICE_KEY 代表用户授权底层治理调用。
2. Bearer gsk_ API 密钥（推荐用于编程客户端） — 将 ACP API 密钥直接作为 Authorization: Bearer gsk_... 传入。密钥的身份就是 ACP 端的行为主体。无需 OAuth。

根据 MCP 授权规范，OAuth 发现元数据通过 /.well-known/oauth-protected-resource 提供。

本地开发

npm install
npm run dev        # tsx-based hot reload

工具定义位于 src/tools/tools.ts。MCP JSON-RPC 处理程序位于 src/handlers/mcpHandler.ts。Express 入口点和速率限制位于 src/server/expressServer.ts。

许可证

MIT — 参见 LICENSE。

链接

• ACP — 完整产品
• 注册（免费层级）
• 治理基准测试
• 问题 / 咨询
• 电子邮件：[email protected]