Api Contract Validator

io.github.lazymac2x由 GitHub 账号 lazymac2x 发布v1.0.0更新于 Oct 25, 2026

Cloudflare Workers MCP server: api-contract-validator

已验证Streamable HTTP可网页运行开发者工具数据与分析

概览

AI 生成的概览

远程 MCP 服务器，让助手校验、检查、比对和生成 OpenAPI 或 AsyncAPI 规范，并检测破坏性变更。

可以做什么
校验 OpenAPI 3.x 或 AsyncAPI 规范 JSON，返回结构错误、缺失必填字段和警告。将真实 HTTP 请求/响应与规范契约比对，返回逐字段违规项。按质量规则检查规范，如 operation ID 使用 kebab-case、必须定义成功响应、定义 tags、描述非空、定义安全方案。依据示例、默认值、格式和类型启发式从规范生成模拟响应数据。比较两个规范版本，检测删除路径、新增必填参数、删除响应码、重命名 operationId 等破坏性变更。
适用场景
适合在评审或维护 API 规范时使用：发布前检查规范、验证实际流量是否符合契约、执行 lint 约定、为测试生成模拟响应，或判断规范变更是否会破坏现有客户端。
运行要求
通过 streamable HTTP 连接远程端点
安装前请注意
提交的规范和请求/响应数据会发送到第三方托管服务，避免包含密钥或敏感数据。所列工具为只读分析与生成，未描述写入或删除操作。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Api Contract Validator，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.lazymac2x%2Fapi-contract-validator/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "api-contract-validator": {
      "type": "http",
      "url": "https://api.lazy-mac.com/api-contract-validator/mcp"
    }
  }
}

README

该仓库没有 README。

工具

5

validate_openapi_spec

Validate an OpenAPI 3.x or AsyncAPI spec JSON. Returns structural errors, missing required fields, and warnings.

输入参数spec必填strict

diff_request_response

Compare a real HTTP request/response against an OpenAPI spec contract. Returns per-field violations.

输入参数spec必填request必填response

lint_api_schema

Lint an API spec for quality and best practice compliance. Rules: operation-id-kebab-case, response-success-required, tags-defined, no-empty-description, security-defined.

输入参数spec必填rules

generate_mock_from_spec

Generate mock response data from an OpenAPI spec. Uses examples, defaults, formats, and type heuristics.

输入参数pathspec必填methodstatusCode

check_breaking_changes

Compare two OpenAPI spec versions to detect breaking changes: removed paths/operations, new required parameters, removed response codes, operationId renames.

输入参数spec_new必填spec_old必填

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 75%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分

    请声明包含 README 的 GitHub 仓库，或在 OAuth 受保护资源元数据中提供 resource_documentation。

  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。