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 分

    請在儲存庫或註冊中心條目中宣告授權條款。