MCP规范验证器
根据以下内容验证MCP服务器规范 OASF MCP模块架构.
运作原理
输入是单个MCP模块JSON对象。\ 它在本地根据捆绑的OASF MCP模块模式(JSON模式草案-07)进行验证。
模块格式
{
"name": "integration/mcp",
"data": {
"name": "my-mcp-server",
"connections": [
{ "type": "streamable-http", "url": "https://example.com/mcp" }
]
}
}必填字段: name (必须是 "integration/mcp"), data.name, data.connections (至少一个条目)。
连接类型: streamable-http, sse, stdio.
看 src/main/resources/samples/ 更多示例。
配置
src/main/resources/application.yaml:
| 属性 | 默认值 | 描述 |
|---|---|---|
oasf.validator.default-schema-version | 1.0.0 | 在以下情况下使用的架构版本 schemaVersion 查询参数缺失 |
server.port | 8060 | 应用端口 |
跑步
mvn spring-boot:runREST API
POST /validate
验证原始MCP模块JSON正文。
查询参数:
| 参数 | 必填 | 说明 |
|---|---|---|
schemaVersion | 否 | 覆盖默认架构版本 |
响应代码:
| 代码 | 含义 |
|---|---|
200 OK | 模块有效 |
422 Unprocessable Entity | 模块无效-- errors 数组非空 |
响应主体:
{
"valid": false,
"errors": [
"$.data.connections: there must be a minimum of 1 items in the array"
],
"warnings": []
}示例(HTTPie)
# Validate a local JSON file
http POST :8060/validate — empty when valid
result.warnings(); // List