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 与机器学习

概览

AI 生成的概览

审计 MCP 工具定义与市场上架描述,为每个工具打 0-100 分并指出导致模型调用出错的具体行。

可以做什么
审计单个工具定义(名称、描述、inputSchema),给出 0-100 友好度评分及带严重程度和修复建议的具体问题。审计整个服务器的工具列表,并做跨工具检查:重名、命名风格混用,以及最差工具汇总。校验面向市场的短描述和长描述是否符合平台限制,包括 500 字符短描述上限。
适用场景
适合在构建或审查 MCP 服务器与工具 schema 时使用,在发布前发现描述含糊、参数文档缺失、命名非动词开头、枚举过大或嵌套过深等问题。也适合在部署前检查上架文案是否超出长度限制。
运行要求
远程 Streamable HTTP 端点,需要 OAuth 认证。README 提到可在 MCPize 订阅托管版(含免费额度,更高额度需付费),或通过 npm install 与 node server.js 在 8080 端口自托管。
安装前请注意
连接需要 OAuth 登录。托管版更高额度需付费订阅。审计工具只读取你提供的定义,但这些定义会发送到远程服务。

安装

在 SourceWeft 中

  1. 打开 控制台中的 MCP Schema Audit,将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储,绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

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:

bash
npm installnode server.js

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).

License

MIT

来源:README.md,提交 e83dfd0

工具

0
该服务器需要登录,因此 SourceWeft 无法在没有账号的情况下读取其工具,也未收录。已连接账号所能看到的内容可能因账号及其权限而异。

版本历史

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

评分

已满足适用检查项的 85%

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

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

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Audit 集成