MCP Agent Assessment

MCP代理评估

统一的MCP代理评估：将MCP验证、A2A代理卡检查、ERC-8004链上验证和信誉查询整合到一个具有严重性分类和比较支持的结构化评估中。

什么是代理人？

在本模块的上下文中 代理 是一个MCP服务器端点，它公开了多达四个协议层的功能：

1. MCP服务器 --通过模型上下文协议提供工具、资源和提示
2. A2A代理卡 --按照谷歌的代理到代理协议发布代理卡
3. ERC-8004注册 --通过ERC-8004代理注册表具有链上身份
4. 链上声誉 --在链上携带可验证的声誉数据

代理不限于单一协议。本模块评估端点提供的全方位功能，从基本的MCP合规性到链上身份和声誉。“代理”一词反映了现代MCP服务器越来越多地充当具有身份、支付能力（x402）和跨协议互操作性的自主服务提供商。

描述

该模块为MCP代理提供了一个全面的4层评估管道。它验证协议合规性、支付能力、代理卡结构、链上注册和信誉数据。结果按严重程度（错误、警告、信息）分类并分级（A/B/C），以便快速进行健康评估。

评估包括：

• 层1：MCP协议验证和x402付款要求（通过 x402-mcp-validator)
• 层2：A2A代理卡结构和功能（通过 a2a-agent-validator)
• 层3：ERC-8004链上注册验证（通过 erc8004-registry-parser)
• 第4层：链上信誉数据查询

快速启动

安装并运行基本评估：

git clone https://github.com/agentprobe/mcp-agent-assessment.git
cd mcp-agent-assessment
npm install

import { McpAgentAssessment } from 'mcp-agent-assessment'

const result = await McpAgentAssessment.assess( {
    endpoint: 'https://mcp.example.com/sse',
    timeout: 15000
} )

console.log( `Grade: ${result.entries.assessment.grade}` )
console.log( `Healthy: ${result.categories.overallHealthy}` )
console.log( `Supports x402: ${result.categories.supportsX402}` )

特性

• 4层评估管道（MCP、A2A、ERC-8004、声誉）
• 严重性分类分为3个级别（错误、警告、信息）
• 基于错误和警告计数的分级系统（A/B/C）
• 22个统一的布尔类别标志
• 快照与每层差异的比较
• 独立层的并行执行
• 每层可配置超时

建筑

评估管道将四个独立的验证器协调成一个统一的结果：

flowchart LR
    A[MCP Server URL] --> B[AssessmentPipeline]
    B --> C[Layer 1: MCP + x402]
    B --> D[Layer 2: A2A Card]
    B --> E[Layer 3: ERC-8004]
    E --> F[Layer 4: Reputation]
    C --> G[SeverityClassifier]
    D --> G
    E --> G
    F --> G
    G --> H[AssessmentBuilder]
    H --> I[Grade A/B/C + Unified Result]

目录

• 方法

- .asset（） - .compare（）

• 严重性系统
• 四层管道
• 类别参考
• 贡献
• 许可证

方法

该模块导出一个类 McpAgentAssessment 采用两种静态方法评估MCP服务器并比较评估结果。

.asset（）

对MCP服务器端点执行完整的4层评估。返回结构化数据，其中包含严重性分类消息、布尔功能标志、分级和原始层结果。

方法

.assess( { endpoint, timeout, erc8004 } )

参数

示例

import { McpAgentAssessment } from 'mcp-agent-assessment'

const result = await McpAgentAssessment.assess( {
    endpoint: 'https://mcp.example.com/sse',
    timeout: 15000,
    erc8004: {
        rpcNodes: {
            'ETHEREUM_MAINNET': 'https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY',
            'BASE_MAINNET': 'https://base-mainnet.g.alchemy.com/v2/YOUR_KEY'
        }
    }
} )

console.log( `Grade: ${result.entries.assessment.grade}` )
console.log( `Errors: ${result.entries.assessment.errorCount}` )
console.log( `Warnings: ${result.entries.assessment.warningCount}` )

退货

returns {
    status: true,
    messages: [
        {
            code: 'PRB-001',
            severity: 'INFO',
            layer: 1,
            location: 'tools',
            message: 'PRB-001 tools: Found 3 tools'
        }
    ],
    categories: { /* 22 boolean flags */ },
    entries: {
        endpoint: 'https://mcp.example.com/sse',
        timestamp: '2026-02-07T10:30:00.000Z',
        mcp: { /* Layer 1 data */ },
        a2a: { /* Layer 2 data */ } | null,
        erc8004: { /* Layer 3 data */ } | null,
        reputation: { /* Layer 4 data */ } | null,
        assessment: {
            errorCount: 0,
            warningCount: 0,
            infoCount: 1,
            grade: 'A'
        }
    },
    layers: {
        mcp: { /* raw Layer 1 result */ },
        a2a: { /* raw Layer 2 result */ },
        erc8004: null,
        reputation: null
    }
}

.compare（）

比较两个评估结果，并返回一个详细的差异，显示所有层的变化。代表MCP和A2A数据的特定层比较器。

方法

.compare( { before, after } )

参数

示例

import { McpAgentAssessment } from 'mcp-agent-assessment'

const resultA = await McpAgentAssessment.assess( { endpoint: 'https://mcp.example.com/sse' } )
// ... changes happen on the server ...
const resultB = await McpAgentAssessment.assess( { endpoint: 'https://mcp.example.com/sse' } )

const diff = McpAgentAssessment.compare( { before: resultA, after: resultB } )

console.log( `Has changes: ${diff.hasChanges}` )
console.log( `Grade changed: ${diff.diff.assessment.grade.before} → ${diff.diff.assessment.grade.after}` )

退货

returns {
    status: true,
    messages: [],
    hasChanges: true,
    diff: {
        mcp: { /* delegated to McpServerValidator.compare() */ },
        a2a: { /* delegated to A2aAgentValidator.compare() */ },
        erc8004: {
            registration: { changed: {} },
            categories: { changed: {} }
        } | null,
        reputation: { changed: {} } | null,
        assessment: {
            grade: { before: 'B', after: 'A' },
            errorCount: { before: 0, after: 0 },
            warningCount: { before: 2, after: 0 },
            categories: {
                changed: {
                    supportsX402: { before: false, after: true }
                }
            }
        }
    }
}

严重性系统

每条诊断消息都分为3个严重级别，决定了整体等级：

错误代码前缀

错误代码遵循以下模式 {PREFIX}-{NUMBER}:

评分

四层管道

评估贯穿四个层次，它们之间存在依赖关系：

执行：

• 第1层和第2层并行运行
• 第3层取决于配置(erc8004 参数）
• 第4层取决于第3层的结果（需要agentId）

类别参考

评估返回22个布尔标志，对服务器功能进行分类：

第1层（MCP+x402）

第2层（A2A）

第3层（ERC-8004）

第4层（声誉）

总体

验证码

评估管道根据严重程度（错误、警告、信息）对每条消息进行分类 SeverityClassifier.

ASM——评估输入验证

REG--ERC-8004注册中心

RPC——链上RPC

REP——声誉

CON--连接（第1层/5层）

CMP——比较

贡献

欢迎PR！请确保：

• 所有公共方法都有测试
• 覆盖率保持在70%以上
• 代码遵循格式标准（4个空格，没有分号，括号内有空格）
• 提交消息参考问题编号

许可证

麻省理工学院