mcp-toolgauge 今日发布

mcp-toolgauge 是一款开源 MCP 服务器质量检测工具，专为 MCP 服务器开发者和 AI 工程团队设计。它通过静态 lint、动态评估和 CI gate 三层检测，全面诊断 MCP 服务器的工具为什么不被模型正确调用。nn核心功能方面，lint 检测器离线运行，无需 API Key，支持 22 条规则，覆盖命名规范（近义名、空壳名称、命名与描述不一致、混合命名风格）、描述质量（缺失、碎片化、重述父级名称、近义工具描述、占位符文本）、参数规范（无描述、重复名称、应转为枚举的自由字符串、日期/邮箱无格式、无类型对象、无示例值）、注解完整性（危险操作无 destructiveHint、只读操作无 readOnlyHint、写操作无 idempotentHint）以及工具预算（单个工具定义过大、工具集过大超出模型可靠选择范围）。nn动态评估器则实际运行模型，测量模型在真实调用中是否选对工具，并用混淆矩阵呈现工具选择准确率，帮助开发者精确定位模型决策盲点。CI gate 将 lint 和评估结果合并为 0-100 健康分，可直接在 GitHub Actions 中 gate 部署流程，确保 MCP 服务器质量持续达标。nn安装使用极其简单：无需安装步骤，直接使用 uvx 运行。uvx mcp-toolgauge lint 扫描代码风格，uvx mcp-toolgauge eval 测试模型实际选择效果，uvx mcp-toolgauge ci 汇总综合评分。输出包含 SHIELD 徽章，可直接嵌入项目 README。nn适用场景包括：MCP 服务器上线前的质量验收、CI/CD 流程中的自动化质量 gate、团队内部 MCP 服务器编码规范检查，以及模型工具选择异常时的根因分析。开发者文档完善，每条规则均有独立说明页，解释规则设计原理并提供修复前后对比示例。