debug-mcp

debug-mcp 技能为调试模型上下文协议 (MCP) 服务器提供了一套结构化、命令行驱动的解决方案。该技能专为与 Microsoft Copilot Studio 协作的开发者设计，协助识别并解决常见的通讯问题，例如工具架构解析错误或因协议不匹配导致的执行失败。通过 grep 进行静态分析、手动验证 JSON-RPC 以及经过验证的检查清单，确保您的 MCP 实现保持稳定、符合规范，并针对 AI 代理的使用进行了优化。

• 自动扫描潜在问题模式，例如会干扰 Copilot Studio 解析的选择性参数、复杂类型 (Union, Optional, List, Dict) 及默认值。

• 包含系统化的验证协议，用于测试服务器连接、验证工具架构注册以及审核运行阶段响应。

• 实现工具设计的最佳实践，例如简化复杂对象，并确保布尔参数被显式处理为字符串。

• 直接整合项目文档与专家级调试代理 (如 mcp-copilot-expert)，以应用已知修复方案。

• 当 Copilot Studio 无法正确呈现工具，或错误地显示原始 JSON-RPC 参数时，请使用此技能。

• 适合需要将工具数量保持在建议的 70 个限制内，以在代理环境中获得最佳性能的开发者。

• 确保所有工具定义都已分析 Python 实现与 MCP 规范之间可能存在的不匹配。

• 实务建议包括将多参数工具拆分为独立函数以避开选择性参数限制，并保持清晰的说明文档以提升模型可解释性。

• 建议结合标准服务器日志使用，以便在开发周期的早期隔离启动错误与连接问题。