MCP Apps Validator

mcp应用程序验证器

验证MCP服务器是否支持UI扩展（SEP-1865）：通过StreamableHTTP或SSE连接，发现 ui:// 资源，验证HTML内容、CSP、权限、显示模式、主题化、工具链接、优雅降级，测量延迟，并返回一个包含12个布尔类别和18个输入字段的结构化快照。

快速启动

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

import { McpAppsValidator } from 'mcp-apps-validator'

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

特性

• 使用SSE回退通过StreamableHTTP连接到MCP服务器
• 发现 ui:// 通过以下方式链接资源和工具UI _meta.ui.resourceUri
• 验证UI资源的HTML内容
• 检查CSP（内容安全策略）配置
• 验证权限声明
• 检测显示模式支持（嵌入式、面板、全屏、弹出）
• 检查主题/样式变量支持
• 验证非UI主机的文本回退是否优雅降级
• 将12个布尔类别（可达、MCP、MCP应用程序、UI资源、工具链接、主题、显示模式）分类
• 测量listResources和readResource延迟
• 比较两个快照并生成结构化差异
• 连接失败时返回包含所有错误类别的空快照

建筑

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

flowchart LR
    A[endpoint] --> B[McpAppsConnector.connect]
    B --> C[McpAppsConnector.discover]
    C --> D[UiResourceValidator.validate]
    D --> E[CapabilityClassifier.classify]
    E --> F[SnapshotBuilder.build]

目录

• 方法

- .start（） - .compare（）

• 分类
• 条目
• 许可证

方法

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

.start()

连接到MCP服务器，发现UI资源，验证HTML内容、CSP、权限、显示模式、主题化、工具链接，测量延迟，并返回结构化快照。

方法

.start( { endpoint, timeout } )

示例

import { McpAppsValidator } from 'mcp-apps-validator'

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

console.log( `Status: ${status ? 'PASS' : 'FAIL'}` )
console.log( `UI Resources: ${entries['uiResourceCount']}` )
console.log( `MCP Apps: ${categories['supportsMcpApps']}` )
console.log( `Extension: ${entries['extensionVersion']}` )

退货

{ status, messages, categories, entries }

______________________________________________________________________

.compare()

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

方法

.compare( { before, after } )

示例

import { McpAppsValidator } from 'mcp-apps-validator'

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

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

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

退货

{ status, messages, hasChanges, diff }

分类

返回了12个布尔标志 categories:

条目

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

验证码

VAL——输入验证

CON-MCP连接

UIR-UI资源访问

UIV-UI验证

CMP——比较

许可证

麻省理工学院