Elysia Tools

在一个清晰的工作台里浏览工具、案例、可视化和主题指南。

热门分类

专题

语言
ZHDERUPTENFRES

Elysia Tools

导航

AI Tools

MCP Server 契约测试器(stdio + WebSocket 双传输 · JSON Schema 2020-12 工具 schema 校验)

· 最后更新:2026-09-13

对 Model Context Protocol 服务器做端到端契约验证:JSON-RPC 2.0 握手与版本协商、capabilities 交换、tools/list 输入 schema 的 object 根类型与 2020-12 草案编译校验、resources 读写、prompts 获取、ping、未知方法 -32601 语义、sampling/createMessage 往返与 stdio 换行分帧纪律;默认内置参考服务器离线自测,亦可对你的 stdio 命令或 ws:// 端点实测。

详情

这个工具可以帮你完成什么

协议依据(initialize 纪元,2024-11-05 … 2025-11-25):initialize 请求携带 protocolVersion、client capabilities 与 clientInfo;服务器回 serverInfo + capabilities;客户端随后必须发送 notifications/initialized 通知。stdio 官方绑定 = 换行分隔的 JSON-RPC(禁内嵌换行、日志走 stderr、stdout 不得出现非 MCP 内容);WebSocket 属规范 §自定义传输 —— 每 JSON-RPC 消息一个文本帧。规范要求每个工具 inputSchema 根节点为 type:object 的 JSON Schema,本工具用 Ajv 2020-12 对每个 schema 编译校验。sampling 是服务器→客户端请求:客户端声明 sampling capability 后,服务器可发 sampling/createMessage(messages[] + maxTokens),本测试器自动应答并验证其结构。2026-07-28 规范改为无状态核心(服务器不再主动发请求),本工具主测经典 initialize 纪元并在报告中注明。默认模式内置一台完全合规的参考服务器,经进程内 stdio 流对 + 真实 127.0.0.1 TCP WebSocket 回环双传输离线自测,结果确定可复现。

执行

运行这个工具

填写表单、运行工具,并在同一页面查看结果。

案例

与这个工具匹配的案例

相关内容

继续查看相关工具与专题

由 Elysia Tools 团队编写

工具使用指南

详细了解工具的适用范围、支持能力及用户案例。

关键事实

分类
AI Tools
输入类型
select, text, number, checkbox
输出类型
html
案例覆盖
4
API 可用
是

概览

MCP Server 契约测试器是一款面向 Model Context Protocol 服务端的自动化合规与协议契约验证工具。它全面支持 stdio 子进程与 WebSocket 双传输通道,深度覆盖 JSON-RPC 2.0 握手、协议版本协商、capabilities 交换、基于 JSON Schema 2020-12 的工具 schema 编译校验、资源读写、提示词获取、未知方法 -32601 语义及 sampling 往返通信,并自动生成结构化的 HTML 合规报告。

适用场景

  • 本地开发自定义 MCP 服务器(stdio 命令行或 WebSocket 端点)并在接入宿主客户端前验证协议合规性与分帧纪律。
  • 为 MCP 服务编写或重构工具 definitions 时,需要通过 Ajv 严格校验 inputSchema 根节点类型与 JSON Schema 2020-12 规范兼容性。
  • 在持续集成流程中自动化验证不同协议修订版(如 2024-11-05、2025-06-18)的版本协商、ping 心跳与 -32601 错误码语义。

使用方式

  1. 1选择测试模式(内置离线参考服务器、stdio 子进程命令或 WebSocket 端点地址),并配置目标协议版本与超时参数。
  2. 2测试器发起连接并执行 JSON-RPC 2.0 initialize 握手请求,协商 protocolVersion,交换 capabilities 并按序发送 initialized 通知。
  3. 3批量向服务端发送 tools/list、resources/read、prompts/get、ping 及未知方法探测指令,并使用 Ajv 编译验证每个工具的 inputSchema。
  4. 4模拟处理服务端发起的 sampling/createMessage 双向抽样请求,检验传输分帧规范,最终输出包含得分矩阵的 HTML 合规报告。

常见用途

  • 排查 Node.js 或 Python MCP 服务的 stdio 分帧异常,确保 stderr 与 stdout 输出隔离且无多余换行。
  • 验证独立 WebSocket MCP 服务的端点连通性、心跳机制与 tools/resources/prompts 清单的契约正确性。
  • 校验支持 sampling 能力的 MCP 服务端在触发 sampling/createMessage 时的数据结构与双向应答流程。

同类对比

  • 一次定义 LLM 工具,同时生成 OpenAI、Anthropic、Gemini 三家经过校验的函数调用 payload。

  • 从JSON对象中提取所有键,支持多种输出格式。非常适合分析JSON结构、生成文档和理解复杂的嵌套对象。

  • 从 JSON 或 CSV 训练计划数据生成可打印 PDF,包含动作表格、进度格子和可选的视频二维码

适合谁

适合

  • 在浏览器中生成JSON 文本。
  • 需要设置测试模式的工作流,例如参考服务器自测(离线,双传输)或stdio 子进程命令。
  • “Offline reference self-test — both transports, full suite”这类工作流,一次完成。

不适合

  • 完全自动化的批量任务——本页面面向交互使用,脚本请调用 API 端点。
  • 其他格式的内容——本工具只接受JSON 文本。

常见失败与 edge cases

  • 尾随逗号或单引号

    严格的 JSON 解析器会拒绝它们——校验或格式化前请去掉尾随逗号并改用双引号。

  • 超大文件

    大文件处理更慢,还可能触及浏览器内存上限——请先用小样本测试。

  • 不检查输出结果

    正式使用前,请先把输出的前几行或前几页与输入对照检查。

示例

1. 本地 stdio MCP 服务契约回归测试

AI 助手插件开发者

背景

开发者正在构建一个管理本地文件系统的 MCP 服务,准备接入 IDE 智能助理。

问题

部分工具 inputSchema 缺少根类型声明,且偶尔向 stdout 输出日志导致 JSON-RPC 分帧解析失败。

如何使用

选择 `stdio 子进程命令` 模式,输入命令 `npx -y @modelcontextprotocol/server-filesystem ./test-dir` 并勾选 schema 校验后运行测试。

mode: stdio-command
serverCommand: npx -y @modelcontextprotocol/server-filesystem ./test-dir
protocolVersion: 2025-06-18
requestTimeoutMs: 5000
validateSchemas: true

结果

报告直观定位了 schema 缺少 type:object 的工具与 stdout 混入非 JSON 的行,修复后全量契约检查均获通过。

2. WebSocket 传输模式与版本协商验证

全栈架构师

背景

团队开发了基于 WebSocket 的远程 MCP 集中网关,需验证多版本协商与未知方法错误处理。

问题

需要确认服务端在面对 2024-11-05 与 2025-06-18 协议请求时能够正确握手,并返回规范的 -32601 错误码。

如何使用

选择 `WebSocket 服务器地址` 模式,填入 `ws://127.0.0.1:3001/mcp`,设定目标版本并启动验证套件。

mode: websocket-url
wsUrl: ws://127.0.0.1:3001/mcp
protocolVersion: 2024-11-05
requestTimeoutMs: 3000
validateSchemas: true

常见问题

工具支持哪些 MCP 传输协议?

支持 stdio(换行分隔的子进程标准输入输出)和 WebSocket(ws:// 或 wss:// 每消息单文本帧)两种传输模式。

为什么工具 schema 校验必须使用 JSON Schema 2020-12?

MCP 规范要求每个工具的 inputSchema 必须是合法的 JSON Schema 且根节点为 object 类型,测试器通过 Ajv 2020-12 确保其符合规范。

参考服务器自测模式有什么作用?

该模式无需依赖外部网络或命令,在内存与回环 TCP 中对内置合规参考服务器运行 34 项全量测试,用于快速确认基准行为与离线演示。

遇到不存在的方法时,测试器期望服务器返回什么?

根据 JSON-RPC 2.0 规范,服务器必须返回错误码为 -32601(Method not found)的标准错误响应。

服务端发生握手异常或超时时会怎样?

测试器不会异常崩溃,而是将连接或握手失败标记为测试未通过项,并在生成的合规报告中详细展示失败原因。

首页
工具3212
案例593
可视化471
文件查看器103
专题239
标签333
图像、音频与视频657

图像、音频、视频处理、转换与优化工具

数学、日期与金融647

计算器、数值计算、日期逻辑、统计与金融工具

设计与颜色298

颜色、版式、图形、视觉样式与设计辅助工具

文本与写作209

写作、清洗、格式化、提取与文本分析工具

开发与 Web193

开发者工具、网络处理、Web 调试与自动化辅助工具

转换与编码175

格式、文件、压缩包、单位与编码转换工具

潜客测验发布与联系人交接
讣告、悼词与纪念卡的家属复核及交付
本地习惯记录的备份、恢复演练与分享前检查
长文改编 X 串文与 LinkedIn 帖子的事实复核与交付
Markdown 互动课件审校、离线演示与交付

© 2026 Elysia Tools. 保留所有权利。

文档价格关于我们服务条款隐私政策Cookie 政策联系我们
数据格式

聊天记录 JSON 示例

多角色聊天记录的 JSON 示例

数据格式

富媒体 JSON 示例

常见富文本编辑器(TipTap、Quill、Slate)的 JSON 示例

开发

Terraform Plan JSON 样本

用于依赖可视化和变更审查的 Terraform plan JSON 文件样本,贴近 terraform show -json 输出结构

数据格式

JSON 示例

JSON(JavaScript 对象表示法)格式示例,从简单到复杂结构

Data Processing

CSV 转数据库迁移规划器

根据 CSV 数据推断关系型 schema,并为 PostgreSQL、MySQL、SQLite 或 SQL Server 生成建表和 ALTER 迁移计划

Design

ECharts 主题 Token 抽取器

从 ECharts 主题 JSON 抽取设计 token——颜色、数字、字号与字符串——并直接导出到你的设计系统。粘贴一个主题对象(即通过 echarts.init(dom, themeName) 注册的那种),工具遍历每个叶子节点,为每个颜色(可选地将命名色/rgb 规范化为 hex)、间距数字、字号与字符串打标,然后输出干净的 CSS 变量、Tailwind theme.extend 配置、Style Dictionary tokens.json 或 SCSS 变量。在 ECharts 可视化主题与 Figma/CSS/Tailwind 设计 token 之间架桥,无需逐个手抄。

Design

图片调色板转设计令牌

从图片中用 k-means 聚类提取主色,导出为 CSS 变量 / SCSS 变量 / Tailwind 配置 / JSON 设计令牌,并自动为每个颜色生成命名色阶

Security

JWK 生成与解析器

生成 RSA、EC(P-256/P-384/P-521/secp256k1)与 OKP(Ed25519/Ed448/X25519/X448)的 JSON Web Key,或解析已有 JWK 以查看参数、指纹与元信息

结果

生成完整的 HTML 契约卡片,确认了 WebSocket 文本帧分帧规范、版本回显及 -32601 错误语义的合规性。

LLM 工具调用 JSON Schema 构建器
JSON键提取器
健身训练 PDF 生成器