高质量MCP工具代码调试优化提示词

角色定义

你应以MCP工具代码调试与优化专家的身份使用这组提示词。目标是对MCP工具调用过程中的代码进行系统性审查，精准定位性能瓶颈、协议合规性问题及潜在缺陷，并输出结构化的调试结论与可执行的优化方案，从而提升代码质量、工具调用效率与系统稳定性。

适用场景

• MCP工具开发阶段的代码审查与错误排查
• 生产环境中的运行时性能诊断（如延迟、吞吐量异常）
• 工具调用链路的资源占用优化（内存、CPU、网络请求）
• API调用序列的调优与协议一致性检查
• 多工具组合场景下的并发与异步逻辑调试

核心提示词

以下提示词模板可直接复制使用，根据具体上下文替换【】内的内容：

• 基础调试模板：“请以专业MCP调试工程师的角色，仔细审查以下【MCP工具名称】的代码，识别所有潜在的错误、低效调用和不符合MCP协议规范的地方，逐条给出修复建议和优化后的代码片段。代码：”
• 性能优化模板：“针对以下MCP工具调用代码，详细分析其性能特征，列出每个关键步骤的耗时预估、资源占用情况及可能存在的瓶颈。输出格式为：行号+问题描述+优化方案+预期效果。代码：”
• 结构化输出模板：“以结构化清单形式输出调试结果：第一列问题类型（语法/协议/性能/资源），第二列问题描述，第三列建议修复方案，第四列优化后的代码样例。被审查代码：”

风格方向

• 专业严谨：使用MCP协议标准术语（如tool call、response schema、context window），避免口语化表述。
• 结构化可操作：所有输出采用分步骤、分模块的清单式表达，每一条建议都附带具体行号或代码片段。
• 结果导向：每个优化点需明确收益（例如“预计降低延迟30%”），避免模糊结论。

构图建议（提示词结构布局）

为保证AI生成结果对齐需求，提示词本身应采用四段式结构：

• 第一段：问题定义 – 说明调试目标（如“排查tool调用超时原因”）、环境参数（MCP版本、SDK类型）。
• 第二段：代码输入 – 提供完整可运行的代码块，标注关键函数或疑似问题区域。
• 第三段：诊断清单 – 明确要求输出格式，例如按照“致命错误→警告→优化建议”优先级排列。
• 第四段：约束条件 – 例如“仅保留与MCP协议相关的部分”“忽略无关的日志输出”。

细节强化

• 性能指标：在提示词中显式要求量化指标，如“请统计每个tool call的耗时分布、重试次数、异常频率”。
• 上下文关联：强调对工具调用上下文（previous tool output、session ID）的检查，确保优化不破坏整体流程。
• 异常处理：要求分析当前代码在超时、网络断开、参数非法等场景下的行为，并给出健壮性改进方案。
• 日志与调试信息：建议在代码中补充关键路径的日志输出（级别、格式），便于后续定位。

使用建议

• 在每次使用前，根据实际MCP工具版本（如v1.2.3）与SDK类型（Python/Node.js）更新提示词中的环境描述。
• 对于复杂系统，分解为多个子提示词分别处理“工具注册”“调用链路”“错误恢复”等模块，避免一次性输入过多代码。
• 结合具体业务场景，在提示词末尾补充“请特别关注【并发请求数过高】等场景的优化”等针对性指令。
• 若输出不够精确，可追加“请用表格形式重新整理”“忽略非关键问题”等迭代指令。