MCP Schema Audit

io.github.tylerscomic-lab由 GitHub 帳號 tylerscomic-lab 發布v1.0.0更新於 Oct 25, 2026

Audits MCP tool definitions for patterns that make models call tools wrong or mis-fill args.

發布方自己的服務：audit.domains - Domain Valuation

已驗證Streamable HTTP可網頁執行開發者工具 AI 與機器學習

服務詳細資訊

識別碼: io.github.tylerscomic-lab/mcp-schema-audit-mcp
傳輸: Streamable HTTP
執行環境: Web executable
信任: Verified
發布於: Sep 16, 2026

安全提示

MCP 服務會接收對話中的工具呼叫請求，並可能執行外部操作。啟用前請先了解該服務能做什麼，並只授予它所需的權限。

註冊中心已驗證此條目所屬的 GitHub 帳號 tylerscomic-lab。這並不表明該帳號就是產品方。

SourceWeft 的檢查只涵蓋條目是否完整、端點是否回應；不審查伺服器的程式碼，也不審查其工具的行為。

在 README 中新增徽章

向讀者展示該 MCP 服務已收錄於 SourceWeft，徽章連結到本頁。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.tylerscomic-lab%2Fmcp-schema-audit-mcp.svg)](https://sourceweft.com/mcp/io.github.tylerscomic-lab%2Fmcp-schema-audit-mcp?utm_source=readme&utm_medium=badge)

概覽

AI 產生的概覽

稽核 MCP 工具定義與市集上架描述，為每個工具打 0-100 分並指出導致模型呼叫出錯的具體行。

可以做什麼: 稽核單一工具定義（名稱、描述、inputSchema），給出 0-100 友善度評分及附嚴重程度與修正建議的具體問題。稽核整個伺服器的工具清單，並做跨工具檢查：重名、命名風格混用，以及最差工具彙總。驗證面向市集的短描述與長描述是否符合平台限制，包括 500 字元短描述上限。
適用情境: 適合在建置或審查 MCP 伺服器與工具 schema 時使用，在發布前找出描述含糊、參數文件缺失、命名非動詞開頭、列舉過大或巢狀過深等問題。也適合在部署前檢查上架文案是否超出長度限制。
執行需求: 遠端 Streamable HTTP 端點，需要 OAuth 驗證。README 提到可在 MCPize 訂閱託管版（含免費額度，更高額度需付費），或透過 npm install 與 node server.js 在 8080 埠自架。

安裝前請注意

連線需要 OAuth 登入。託管版更高額度需付費訂閱。稽核工具只讀取你提供的定義，但這些定義會傳送到遠端服務。

安裝

在 SourceWeft 中

開啟儀表板中的 MCP Schema Audit，將其新增到工作區。
連接所需的憑證。它們會被私密儲存，絕不會在公開頁面上展示。
為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.tylerscomic-lab%2Fmcp-schema-audit-mcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。客戶端會在首次連接時完成 OAuth 登入。

{
  "mcpServers": {
    "schema-audit": {
      "type": "http",
      "url": "https://mcp-schema-audit-mcp.mcpize.run/mcp"
    }
  }
}

README

mcp-schema-audit-mcp

[License: MIT] [Live on MCPize]

An MCP server that audits other MCP tool definitions and marketplace listings for the specific patterns that make models call tools wrong, never call them, or mis-fill their parameters — vague descriptions, missing parameter docs, non-verb-first naming, oversized enums, deeply nested schemas — plus MCPize's own 500-character description limit, which fails at deploy time with no warning until you hit it.

Most tool-definition bugs don't throw errors. They just make a model call the wrong tool, or call the right tool with the wrong arguments, silently and intermittently. This scores every tool 0-100 and tells you exactly which line to fix.

Why this exists

Verb-first naming, parameter descriptions, and schema depth aren't cosmetic — they measurably change how reliably a model picks and fills a tool. This project encodes those patterns as an actual auditor instead of a blog post you have to remember to re-read every time you write a new tool.

Tools

`audit_tool_definition`

Audit a single tool (name, description, inputSchema). Returns a 0-100 friendliness score and a list of concrete issues, each with severity, why it matters, and the fix.

`audit_tool_batch`

Same checks across an entire server's tool list, plus cross-tool checks: duplicate names, inconsistent naming convention (snake_case vs camelCase mixed in one server), and a worst-offenders summary.

`check_marketplace_description`

Validates a marketplace-facing short/long description against known platform limits — specifically catches MCPize's 500-character short-description cap before you burn a deploy attempt finding out the hard way.

Use it

Hosted (recommended, no setup): subscribe on MCPize — free tier included, $7/mo for higher limits.

Self-host:

Exposes a Streamable HTTP MCP endpoint on :8080 (/mcp), health check at /health.

Part of a small suite

Built alongside three sibling correctness-audit tools for Claude Code / MCP builders: cron-schedule-audit-mcp (DST-correct cron validation), regex-safety-audit-mcp (ReDoS detection), and claude-cost-audit-mcp (exact Claude API cost + cache-economics calculator).