mcpField
M
MCP Schema Audit

MCP Schema Audit

远程服务
github.com/tylerscomic-lab开发工具014 周前更新
代码仓库

关于 MCP Schema Audit

MCP Schema Audit 是面向 MCP 工具开发者的 MCP 服务,可审查工具定义和市场页面。它为定义评分并指出可能导致模型选错工具或错误填写参数的具体问题。

主要功能

  1. 01为单个工具定义打 0–100 分
  2. 02批量审计并检查工具间问题
  3. 03标记描述含糊或参数文档缺失
  4. 04检查命名、枚举规模和架构深度
  5. 05验证市场描述长度限制

适用场景

  1. 01发布前审查新工具
  2. 02查找同一服务中不一致的命名
  3. 03在市场部署前检查描述长度

MCP 相关

向 MCP 客户端提供审计工具,可检查单个定义、工具批次和市场描述。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://mcp-schema-audit-mcp.mcpize.run/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

mcp-schema-audit-mcp

License: MIT Live on MCPize

一个用于审计其他 MCP 工具定义和市场列表的 MCP 服务,专门检查那些会导致模型错误调用工具、完全不调用工具或错误填写参数的模式——描述含糊、缺少参数文档、命名未采用动词开头、枚举过大、架构嵌套过深——以及 MCPize 自身 500 个字符的描述限制:只有在部署时触发限制才会失败,而且不会提前警告。

大多数工具定义错误都不会抛出错误。它们只会让模型静默且间歇性地调用错误的工具,或使用错误的参数调用正确的工具。此服务会为每个工具打出 0–100 分,并准确指出需要修复的行。

为什么要做这个项目

动词开头的命名、参数描述和架构深度都不是表面功夫——它们会实实在在地影响模型选择和填写工具的可靠性。本项目将这些模式编入真正的审计工具,而不是写成一篇博客,让你每次编写新工具时都得记得重新阅读。

工具

audit_tool_definition

审计单个工具(名称、描述、inputSchema)。返回 0–100 的易用性评分,以及一系列具体问题;每项都说明严重程度、问题的重要性和修复方法。

audit_tool_batch

对整个服务的工具列表执行相同检查,并额外进行跨工具检查:名称重复、命名风格不一致(同一服务中混用 snake_case 和 camelCase),以及问题最严重项的摘要。

check_marketplace_description

根据已知的平台限制验证面向市场的简短/完整描述——特别会在你白白浪费一次部署机会之前,检查 MCPize 的 500 字符简短描述上限。

使用方法

托管服务(推荐,无需设置): 在 MCPize 订阅——包含免费套餐;更高限额为每月 7 美元。

自托管:

npm install
node server.js

在 :8080 上提供 Streamable HTTP MCP 端点(/mcp),并在 /health 提供健康检查。

小型工具套件的一部分

与另外三个面向 Claude Code / MCP 构建者的正确性审计工具一同开发: cron-schedule-audit-mcp(考虑夏令时的 cron 验证)、regex-safety-audit-mcp(ReDoS 检测)和 claude-cost-audit-mcp(精确的 Claude API 费用 + 缓存经济性计算器)。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。