X402 MCP Validator

x402 mcp验证器

端到端验证MCP服务器：通过StreamableHTTP或SSE连接，发现功能，探测每个工具的x402支付要求，根据x402规范验证支付选项，测量延迟，并返回一个包含12个布尔类别和13个输入字段的结构化快照。

快速启动

git clone https://github.com/agentprobe/x402-mcp-validator.git
cd x402-mcp-validator
npm i

import { McpServerValidator } from 'x402-mcp-validator'

const { status, messages, categories, entries } = await McpServerValidator.start( {
    endpoint: 'https://your-mcp-server.example.com/mcp',
    timeout: 15000
} )

特性

• 使用SSE回退通过StreamableHTTP连接到MCP服务器
• 发现工具、资源、提示和功能
• 探测每个工具的x402支付要求（HTTP 402/JSON-RPC-32402）
• 验证付款选项：方案、网络、金额、资产、付款对象、支票金额
• 对12个布尔类别进行分类（可达、MCP、x402、EVM、Solana、任务、mcpApps）
• 测量ping和listTools延迟
• 比较两个快照并生成结构化差异
• 连接失败时返回包含所有错误类别的空快照

建筑

验证管道按六个顺序步骤处理MCP服务器：

flowchart LR
    A[endpoint] --> B[McpConnector.connect]
    B --> C[McpConnector.discover]
    C --> D[CapabilityClassifier.classify]
    D --> E[X402Prober.probe]
    E --> F[PaymentValidator.validate]
    F --> G[SnapshotBuilder.build]

目录

• 方法

- .start（） - .compare（）

• 分类
• 条目
• 许可证

方法

所有方法都是静态的。参数作为对象传递，返回值是对象。

.start()

连接到MCP服务器，发现功能，探测x402支付支持，验证支付要求，测量延迟，并返回结构化快照。

方法

.start( { endpoint, timeout } )

示例

import { McpServerValidator } from 'x402-mcp-validator'

const { status, messages, categories, entries } = await McpServerValidator.start( {
    endpoint: 'https://your-mcp-server.example.com/mcp',
    timeout: 15000
} )

console.log( `Status: ${status ? 'PASS' : 'FAIL'}` )
console.log( `Tools: ${entries['tools'].length}` )
console.log( `x402: ${categories['supportsX402']}` )
console.log( `Networks: ${JSON.stringify( entries['x402']['networks'] )}` )

退货

{ status, messages, categories, entries }

______________________________________________________________________

.compare()

比较由生成的两个快照 .start() 并返回一个结构化的diff，每个部分包含添加、删除和修改的项目。

方法

.compare( { before, after } )

示例

import { McpServerValidator } from 'x402-mcp-validator'

const before = await McpServerValidator.start( { endpoint: 'https://server.example.com/mcp' } )
const after = await McpServerValidator.start( { endpoint: 'https://server.example.com/mcp' } )

const { status, messages, hasChanges, diff } = McpServerValidator.compare( { before, after } )

console.log( `Changes detected: ${hasChanges}` )
console.log( `Tools added: ${diff['tools']['added'].length}` )
console.log( `Tools removed: ${diff['tools']['removed'].length}` )

退货

{ status, messages, hasChanges, diff }

分类

返回了12个布尔标志 categories:

条目

中返回了13个数据字段 entries:

验证码

VAL——输入验证

CON-MCP连接

PAY——付款验证

PRB--探头

OAuth--OAuth

CMP——比较

许可证

麻省理工学院