MCP Agent Validator

AgentProbe — Multi-Protocol Agent Validator

代理探针（MCP代理验证器）

用于AI代理端点的基于Web的多协议验证器。输入URL并跨八个协议层（HTTP、MCP、A2A/AP2、x402、OAuth、MCP Apps、HTML和ERC-8004）进行即时评估。

现场演示： https://agentprobe.xyz

视频： https://www.youtube.com/watch?v=gnmsCEly3fA

DoraHacks： https://dorahacks.io/buidl/39293

太长，读不下去了

• 问题： 代理端点很难在多个不断演进的协议中进行验证。
• 解决方案： 一个URL→ 跨HTTP、MCP、A2A/AP2、x402、OAuth、MCP应用程序、HTML和ERC-8004的统一评估。
• 好处： 更快的调试、更安全的集成和更清晰的合规信号。

演示视频


快速启动

git clone https://github.com/agentprobe/mcp-agent-validator.git
cd mcp-agent-validator
npm install
npm run start:dev

打开 http://localhost:4000 在浏览器中输入端点URL进行验证。

运作原理

• 输入： 单个代理终结点URL。
• 评估： 服务器运行 mcp-agent-assessment 带有协议特定验证器的管道。
• 输出： 每个协议层的统一判决加上原始评估输出。

特性

• 超文本传输协议 --连接、HTTPS、SSL验证、CORS、HTTP/2检测
• 主控程序 --服务器发现、工具/资源/提示列表、功能检测
• A2A/AP2 --代理卡验证、AP2版本和角色检测 capabilities.extensions 和 X-A2A-Extensions 头球
• x402 --通过方案、网络和令牌分析进行支付所需的端点检测
• OAuth --授权服务器元数据发现
• MCP应用程序 --MCP应用程序的UI资源检测
• 超文本标记语言 --网站检测、内容类型、SSL状态、HTTP/2
• ERC-8004 --使用OASF分类、信誉和元数据提取进行链上代理注册表查找

建筑

flowchart LR
    A[URL Input] --> B[Server]
    B --> C[mcp-agent-assessment]
    C --> HTTP[HTTP]
    C --> MCP[MCP]
    C --> A2A[A2A/AP2]
    C --> X402[x402]
    C --> OA[OAuth]
    C --> APPS[MCP Apps]
    C --> HTML[HTML]
    C --> E8[ERC-8004]
    HTTP --> I[Results]
    MCP --> I
    A2A --> I
    X402 --> I
    OA --> I
    APPS --> I
    HTML --> I
    E8 --> I

API

POST /api/validate

返回一个结构化的验证结果，每个协议都有单独的部分。

curl -X POST http://localhost:4000/api/validate \
  -H 'Content-Type: application/json' \
  -d '{"url": "https://your-endpoint.example.com"}'

响应 包含 mcp, a2a, ui （MCP应用程序），以及 oauth 对象与 status, categories, summary，以及 messages.A2A结果包括AP2版本、角色和检测到的扩展URI。

POST /api/assess

返回原始评估结果 mcp-agent-assessment 具有完整的图层细节。

curl -X POST http://localhost:4000/api/assess \
  -H 'Content-Type: application/json' \
  -d '{"url": "https://your-endpoint.example.com"}'

可选参数： timeout （数量，ms）， erc8004 （对象与 rpcNodes).

POST /api/lookup

查询ERC-8004链上注册表以获取代理注册数据、端点、OASF分类和信誉。

curl -X POST http://localhost:4000/api/lookup \
  -H 'Content-Type: application/json' \
  -d '{"agentId": 2340, "chainId": 8453}'

认证

身份验证是可选的。当 API_TOKEN 未设置，API处于打开状态（开发模式）。

当 API_TOKEN 设置后，支持两种身份验证方法：

# With Bearer token
curl -X POST http://localhost:4000/api/validate \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer your-token-here' \
  -d '{"url": "https://your-endpoint.example.com"}'

环境变量

项目结构

src/
├── server/
│   ├── Server.mjs          # HTTP server, routing, auth, API handlers
│   └── StaticFiles.mjs     # Static file serving for docs/
├── mcp/
│   └── McpServer.mjs       # Built-in MCP server (validate, lookup, client introspection)
├── prober/
│   ├── AssessmentProbe.mjs  # Maps assessment results to UI-friendly format
│   └── AgentLookup.mjs     # Direct ERC-8004 on-chain registry queries
docs/
├── index.html              # Single-page frontend
└── style.css               # Styles
tests/
└── unit/
    ├── server.test.mjs     # Server route, auth, and API tests
    ├── static-files.test.mjs
    └── assessment-probe.test.mjs

依赖项

• mcp试剂评估 --统一评估管道（MCP、A2A/AP2、x402、OAuth、MCP应用程序）
• a2a代理验证器 --A2A代理卡和AP2扩展检测
• x402 mcp验证器 --x402支付协议验证
• mcp应用程序验证器 --MCP Apps UI资源检测
• erc8004注册表解析器 --ERC-8004链上注册表解析

由...建造

a6b8

许可证

麻省理工学院