MCPF A2a Registry

MCPAI代理

提供方 MCPTrustFramework

AI代理 未标注 无需鉴权 社区 / 第三方

MCPF代理间注册表(A2A)是一个管理AI代理间任务委托关系的系统,提供策略强制执行和审计日志功能,适用于金融风控、医疗诊断等场景。

一句话选型结论

按资料字段整理

MCPF A2a Registry 属于AI代理类 MCP 服务器,传输方式未标注,无需鉴权,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 2 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

AI代理管理JavaScript本地部署任务委托系统策略强制执行审计日志分布式系统

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCPF A2a Registry当前 未标注 未标注 未标注 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方MCPTrustFramework上游标注的维护方 MCPTrustFramework
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

12.6 KB
来自项目仓库与上游目录的原文,未做删改

MCPF代理到代理注册表(A2A)

AI代理的委托控制 -注册表,用于管理哪些代理可以将任务委托给哪些其他代理,并具有策略执行和审计日志记录功能。

🌟 什么是A2A注册?

代理到代理(A2A)注册表管理AI代理之间的委托关系:```
Agent A (fraud-detector)
↓ wants to delegate to
Agent B (risk-analyzer)
↓ check registry
A2A Policy: ALLOWED (with constraints)
↓ enforce policy
Delegation proceeds with audit log


**基于谷歌的A2A协议和MCPF规范**

## 特性

- **🔐 授权政策** -定义谁可以委派给谁
- **📋 策略注册表** -持久存储委托规则
- **✅ 实时授权** -检查委派权限
- **🔍 审计日志** -完整的代表团历史
- **⚡ 政策限制** -时间限制、范围限制、条件
- **🔄 撤销** -即时策略撤销
- **🗄️ PostgreSQL后端** -生产就绪数据库
- **🚀 REST API** -简单的HTTP/JSON接口

## 🚀 快速开始

### 使用Docker(推荐)```bash
# Clone repository
git clone https://github.com/MCPTrustFramework/MCPF-a2a-registry.git
cd MCPF-a2a-registry

# Start service
docker-compose up -d

# Verify running
curl http://localhost:4003/health
# {"status":"ok"}

# Check delegation policy
curl 'http://localhost:4003/a2a/check?from=did:web:agent1.example&to=did:web:agent2.example'

手动安装```bash

Install dependencies

cd src
npm install

Set up database

createdb mcpf_a2a
psql mcpf_a2a < db.sql

Configure

cp .env.example .env

Edit .env

Run

npm start


## 📖 api参考

### 核心终点

#### 检查委派权限```http
GET /a2a/check?from={fromDID}&amp;to={toDID}&amp;action={action}

例子:```bash
curl 'http://localhost:4003/a2a/check?from=did:web:fraud-detector.bank.example&to=did:web:risk-analyzer.bank.example&action=analyze'


**答复:**```json
{
&quot;allowed&quot;: true,
&quot;policy&quot;: {
&quot;id&quot;: &quot;pol_123&quot;,
&quot;fromAgent&quot;: &quot;did:web:fraud-detector.bank.example&quot;,
&quot;toAgent&quot;: &quot;did:web:risk-analyzer.bank.example&quot;,
&quot;allowedActions&quot;: [&quot;analyze&quot;, &quot;query&quot;],
&quot;constraints&quot;: {
&quot;maxDuration&quot;: 3600,
&quot;scope&quot;: [&quot;transaction-data&quot;],
&quot;requiresApproval&quot;: false
},
&quot;status&quot;: &quot;active&quot;,
&quot;issuedBy&quot;: &quot;did:web:bank.example&quot;,
&quot;validFrom&quot;: &quot;2025-01-01T00:00:00Z&quot;,
&quot;validUntil&quot;: &quot;2026-01-01T00:00:00Z&quot;
}
}

列出所有政策```http

GET /a2a/policies?page=1&limit=50


**答复:**```json
{
&quot;page&quot;: 1,
&quot;limit&quot;: 50,
&quot;total&quot;: 15,
&quot;items&quot;: [
{
&quot;id&quot;: &quot;pol_123&quot;,
&quot;fromAgent&quot;: &quot;did:web:fraud-detector.bank.example&quot;,
&quot;toAgent&quot;: &quot;did:web:risk-analyzer.bank.example&quot;,
&quot;allowedActions&quot;: [&quot;analyze&quot;, &quot;query&quot;],
&quot;constraints&quot;: {...},
&quot;status&quot;: &quot;active&quot;,
&quot;createdAt&quot;: &quot;2025-01-01T00:00:00Z&quot;
}
]
}

获取代理策略```http

GET /a2a/policies/from/:did
GET /a2a/policies/to/:did


**例子:**```bash
# Get all policies where agent can delegate FROM
curl http://localhost:4003/a2a/policies/from/did:web:fraud-detector.bank.example

# Get all policies where others can delegate TO this agent
curl http://localhost:4003/a2a/policies/to/did:web:risk-analyzer.bank.example

注册委派策略```http

POST /a2a/policies
Content-Type: application/json

{
"fromAgent": "did:web:fraud-detector.bank.example",
"toAgent": "did:web:risk-analyzer.bank.example",
"allowedActions": ["analyze", "query", "report"],
"constraints": {
"maxDuration": 3600,
"scope": ["transaction-data"],
"requiresApproval": false,
"maxConcurrent": 5
},
"issuedBy": "did:web:bank.example",
"validFrom": "2025-01-01T00:00:00Z",
"validUntil": "2026-01-01T00:00:00Z"
}


#### 撤销政策```http
POST /a2a/revoke
Content-Type: application/json

{
&quot;policyId&quot;: &quot;pol_123&quot;,
&quot;reason&quot;: &quot;Agent credentials compromised&quot;
}

审核日志```http

GET /a2a/audit?from={fromDID}&to={toDID}&action={action}&startDate={date}&endDate={date}


**例子:**```bash
curl &#x27;http://localhost:4003/a2a/audit?from=did:web:fraud-detector.bank.example&amp;startDate=2025-01-01&#x27;

答复:```json
{
"entries": [
{
"id": "audit_456",
"timestamp": "2025-01-15T10:30:00Z",
"fromAgent": "did:web:fraud-detector.bank.example",
"toAgent": "did:web:risk-analyzer.bank.example",
"action": "analyze",
"result": "allowed",
"policyId": "pol_123",
"metadata": {
"requestId": "req_789",
"duration": 245
}
}
]
}


## 🏗️ 建筑```
┌─────────────────────────────────────┐
│  HTTP API (Express.js)               │
│  /a2a/check, /a2a/policies           │
└──────────────┬──────────────────────┘
│
┌──────────────┴──────────────────────┐
│  A2A Authorization Engine            │
│  • Policy matching                   │
│  • Constraint validation             │
│  • Audit logging                     │
└──────────────┬──────────────────────┘
│
┌──────────────┴──────────────────────┐
│  PostgreSQL Database                 │
│  • a2a_policies table                │
│  • a2a_audit_log table               │
│  • Indexes on DIDs, actions          │
└─────────────────────────────────────┘

📊 数据库模式

a2a_policy表```sql

CREATE TABLE a2a_policies (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
from_agent TEXT NOT NULL, -- Delegating agent DID
to_agent TEXT NOT NULL, -- Receiving agent DID
allowed_actions JSONB NOT NULL, -- Array of allowed actions
constraints JSONB NOT NULL DEFAULT '{}', -- Policy constraints
status TEXT NOT NULL DEFAULT 'active', -- active|revoked
issued_by TEXT NOT NULL, -- Policy issuer DID
valid_from TIMESTAMPTZ NOT NULL,
valid_until TIMESTAMPTZ,
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
updated_at TIMESTAMPTZ NOT NULL DEFAULT now(),
revoked_at TIMESTAMPTZ,
revocation_reason TEXT,
UNIQUE(from_agent, to_agent)
);


### a2a_audit_log表```sql
CREATE TABLE a2a_audit_log (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
timestamp TIMESTAMPTZ NOT NULL DEFAULT now(),
from_agent TEXT NOT NULL,
to_agent TEXT NOT NULL,
action TEXT NOT NULL,
result TEXT NOT NULL,                  -- allowed|denied
policy_id UUID,
metadata JSONB NOT NULL DEFAULT &#x27;{}&#x27;,
created_at TIMESTAMPTZ NOT NULL DEFAULT now()
);

索引```sql

CREATE INDEX idx_a2a_policies_from ON a2a_policies (from_agent);
CREATE INDEX idx_a2a_policies_to ON a2a_policies (to_agent);
CREATE INDEX idx_a2a_policies_status ON a2a_policies (status);
CREATE INDEX idx_a2a_audit_timestamp ON a2a_audit_log (timestamp DESC);
CREATE INDEX idx_a2a_audit_from ON a2a_audit_log (from_agent);
CREATE INDEX idx_a2a_audit_to ON a2a_audit_log (to_agent);


## 🔐 政策限制

政策支持各种约束:```json
{
&quot;constraints&quot;: {
&quot;maxDuration&quot;: 3600,              // Max delegation duration (seconds)
&quot;scope&quot;: [&quot;data-type-1&quot;],         // Data/resource scope
&quot;requiresApproval&quot;: false,        // Human approval required
&quot;maxConcurrent&quot;: 5,               // Max concurrent delegations
&quot;allowedDays&quot;: [&quot;Mon&quot;,&quot;Tue&quot;],     // Day restrictions
&quot;allowedHours&quot;: [9, 17],          // Hour restrictions (9 AM - 5 PM)
&quot;ipWhitelist&quot;: [&quot;192.168.1.0/24&quot;],// IP restrictions
&quot;conditions&quot;: {                    // Custom conditions
&quot;minimumRiskScore&quot;: 0.7,
&quot;requiresEncryption&quot;: true
}
}
}

🐳 Docker部署

docker-compose.yml```yaml

version: '3.8'

services:
a2a-registry:
build: .
ports:
- "4003:4003"
environment:
- DATABASE_URL=postgresql://postgres:password@db:5432/mcpf_a2a
- PORT=4003
depends_on:
- db
restart: unless-stopped

db:
image: postgres:16-alpine
environment:
- POSTGRES_DB=mcpf_a2a
- POSTGRES_PASSWORD=password
volumes:
- postgres_data:/var/lib/postgresql/data
restart: unless-stopped

volumes:
postgres_data:


## 📝 例子

### 示例1:银行欺诈检测```bash
# Register policy: fraud-detector can delegate to risk-analyzer
curl -X POST http://localhost:4003/a2a/policies \
-H &#x27;Content-Type: application/json&#x27; \
-d &#x27;{
&quot;fromAgent&quot;: &quot;did:web:fraud-detector.bank.example&quot;,
&quot;toAgent&quot;: &quot;did:web:risk-analyzer.bank.example&quot;,
&quot;allowedActions&quot;: [&quot;analyze&quot;, &quot;query&quot;, &quot;report&quot;],
&quot;constraints&quot;: {
&quot;maxDuration&quot;: 3600,
&quot;scope&quot;: [&quot;transaction-data&quot;],
&quot;requiresApproval&quot;: false,
&quot;maxConcurrent&quot;: 5
},
&quot;issuedBy&quot;: &quot;did:web:bank.example&quot;,
&quot;validFrom&quot;: &quot;2025-01-01T00:00:00Z&quot;,
&quot;validUntil&quot;: &quot;2026-01-01T00:00:00Z&quot;
}&#x27;

# Check if delegation is allowed
curl &#x27;http://localhost:4003/a2a/check?from=did:web:fraud-detector.bank.example&amp;to=did:web:risk-analyzer.bank.example&amp;action=analyze&#x27;

示例2:医疗诊断链```bash

Register policy: primary-diagnostics can delegate to specialist-ai

curl -X POST http://localhost:4003/a2a/policies \
-H 'Content-Type: application/json' \
-d '{
"fromAgent": "did:web:primary-diagnostics.hospital.example",
"toAgent": "did:web:radiology-specialist.hospital.example",
"allowedActions": ["analyze-xray", "analyze-ct", "generate-report"],
"constraints": {
"maxDuration": 1800,
"scope": ["radiology-images"],
"requiresApproval": true,
"allowedDays": ["Mon","Tue","Wed","Thu","Fri"]
},
"issuedBy": "did:web:hospital.example",
"validFrom": "2025-01-01T00:00:00Z",
"validUntil": "2025-12-31T23:59:59Z"
}'


### 示例3:客户服务升级```bash
# Register policy: chatbot can escalate to supervisor-ai
curl -X POST http://localhost:4003/a2a/policies \
-H &#x27;Content-Type: application/json&#x27; \
-d &#x27;{
&quot;fromAgent&quot;: &quot;did:web:chatbot-l1.company.example&quot;,
&quot;toAgent&quot;: &quot;did:web:supervisor-ai.company.example&quot;,
&quot;allowedActions&quot;: [&quot;escalate&quot;, &quot;review&quot;, &quot;approve&quot;],
&quot;constraints&quot;: {
&quot;maxDuration&quot;: 600,
&quot;scope&quot;: [&quot;customer-support&quot;],
&quot;requiresApproval&quot;: false,
&quot;conditions&quot;: {
&quot;minimumSeverity&quot;: &quot;medium&quot;,
&quot;customerTier&quot;: [&quot;premium&quot;, &quot;enterprise&quot;]
}
},
&quot;issuedBy&quot;: &quot;did:web:company.example&quot;,
&quot;validFrom&quot;: &quot;2025-01-01T00:00:00Z&quot;
}&#x27;

🧪 测试```bash

Run tests

npm test

With coverage

npm run test:coverage

Integration tests

npm run test:integration


## 📈 演出

标准硬件(4 CPU,8GB RAM)上的基准测试:

|操作|性能|注意事项|
|-----------|-------------|-------|
|检查委托|~8ms|索引查询|
|列出策略|~15ms|分页|
|注册策略|~20ms|插入+验证|
|审核日志条目|~5ms|异步写入|
|吞吐量|~3000请求/秒|检查操作|

## 🔗 与MCPF集成

### 有了MCPF,vc```javascript
import { VCVerifier } from &#x27;mcpf-did-vc&#x27;;
import { A2ARegistry } from &#x27;mcpf-a2a-registry&#x27;;

const a2a = new A2ARegistry(&#x27;http://localhost:4003&#x27;);
const verifier = new VCVerifier();

// Before delegation, verify both agents
const fromAgentValid = await verifier.verifyAgent(fromDID);
const toAgentValid = await verifier.verifyAgent(toDID);

if (fromAgentValid &amp;&amp; toAgentValid) {
// Check delegation permission
const result = await a2a.check(fromDID, toDID, &#x27;analyze&#x27;);

if (result.allowed) {
// Proceed with delegation
await delegateTask(fromDID, toDID, taskData);
}
}

使用MCPF ans```javascript

import { ANSClient } from 'mcpf-ans';
import { A2ARegistry } from 'mcpf-a2a-registry';

// Resolve agent names
const ans = new ANSClient('https://ans.example.com');
const fromAgent = await ans.resolve('fraud-detector.risk.bank.example.agent');
const toAgent = await ans.resolve('risk-analyzer.analytics.bank.example.agent');

// Check delegation
const a2a = new A2ARegistry('http://localhost:4003');
const result = await a2a.check(fromAgent.card.did, toAgent.card.did, 'analyze');


### 使用谷歌A2A协议

MCPF A2A注册表实现了谷歌的A2A协议概念:```javascript
// Google A2A style delegation
{
&quot;agent&quot;: &quot;did:web:fraud-detector.bank.example&quot;,
&quot;delegateTo&quot;: &quot;did:web:risk-analyzer.bank.example&quot;,
&quot;task&quot;: {
&quot;type&quot;: &quot;analyze&quot;,
&quot;data&quot;: {...}
},
&quot;authorization&quot;: {
&quot;registry&quot;: &quot;https://a2a-registry.example.com&quot;,
&quot;policyId&quot;: &quot;pol_123&quot;
}
}

🤝 贡献

看 贡献.md 作为指导方针。

📝 许可证

MIT许可证-请参阅 许可证

📞 联系

  • 网站: https://mcpf.dev
  • github: https://github.com/MCPTrustFramework/MCPF-a2a-registry
  • 问题: https://github.com/MCPTrustFramework/MCPF-a2a-registry/issues
  • 讨论: https://github.com/MCPTrustFramework/MCPF-a2a-registry/discussions

🙏 致谢

基于:

  • 谷歌A2A协议 -代理对代理委托概念
  • MCPF规范 -信任框架集成

🔗 相关项目

  • MCPF规范 -SSOT
  • MCPF做了vc -DID/VC基础设施
  • MCPF安 -代理名称服务
  • MCPF注册表 -MCP信托登记处

版本: 1.0.0-alpha\
最后更新时间: 2025年12月31日\
状态: 生产准备就绪

常见问题

5 问
答案由本站依据条目字段整理,不引用上游原文
MCPF A2a Registry 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

MCPF A2a Registry 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

MCPF A2a Registry 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCPF A2a Registry 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

MCPF A2a Registry 能提供哪些能力?

资料显示能力标签包括 JavaScript、分布式系统、AI代理。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。