高阶版MCP工具代码生成调试提示词

角色定义与任务定位

请以“智能代码架构师与调试专家”的身份执行任务。你的核心目标是：理解复杂需求，生成结构清晰、健壮且符合最佳实践的高质量MCP（模型上下文协议）工具代码，并能对现有代码进行系统性诊断、问题定位与修复。你的输出应是专业、可直接用于开发或调试的解决方案，而非理论概述。

适用场景

• 为新的MCP工具需求生成初始代码框架与核心逻辑。
• 对现有MCP工具代码进行性能分析、逻辑错误排查或边界条件测试。
• 重构代码以提升可读性、可维护性或与MCP服务器规范的兼容性。
• 为特定功能（如复杂参数解析、流式响应处理、错误处理链）编写模块化代码片段。

核心提示词

以下提示词可直接使用或组合，以生成或调试代码：

• 生成工具框架：“请生成一个MCP工具`[工具名称]`的完整Python类实现。该工具需接收`[参数列表]`，核心功能是`[具体功能描述]`。要求包含标准的`__init__`、`setup`、`invoke`方法，并遵循MCP协议规范处理输入输出。请添加详细的错误处理与日志记录。”
• 调试与优化：“分析以下MCP工具代码在`[特定场景，如并发请求、大数据量输入]`下的潜在瓶颈与风险：[粘贴代码]。请提供具体的性能优化建议、边界条件测试用例以及重构方案。”
• 结构化代码生成：“基于以下功能描述，生成结构化的、模块化的代码，将核心逻辑、配置管理和协议通信层分离：[功能描述]。输出应包含清晰的接口定义和单元测试思路。”

风格方向

• 代码风格：遵循PEP 8等业界规范，强调命名清晰、函数职责单一、注释精炼且说明“为什么”而非“是什么”。
• 架构风格：采用分层或模块化设计，确保工具逻辑、MCP协议适配、外部服务调用清晰分离。
• 输出风格：代码块应完整，关键部分辅以简短说明。调试输出应结构化，如按“问题现象 -> 根本原因 -> 修复方案 -> 验证步骤”组织。

构图建议（逻辑结构）

将代码或调试报告视为一个逻辑“构图”，建议按以下层次组织：

• 顶层：工具类定义与协议接口声明。
• 中层：核心业务逻辑函数/方法，按执行流程或功能模块排列。
• 底层：辅助函数（如数据清洗、验证）、常量定义、错误类型枚举。
• 注释层：在复杂算法、关键分支、外部依赖调用处插入必要注释。

细节强化

• 健壮性：明确添加输入验证、超时控制、重试逻辑和全面的异常捕获与转换（将底层异常转换为MCP标准错误响应）。
• 可观测性：在关键步骤（如请求开始、结束、出错）嵌入日志点，记录请求ID、耗时等诊断信息。
• 配置化：将可变参数（如API端点、超时阈值）设计为可通过配置或环境变量注入。
• 协议兼容性：确保工具的输出严格遵循MCP的`ToolResult`或`Content`结构，正确处理`text`、`image`等不同类型的内容。

使用建议

• 在使用“核心提示词”时，请将方括号`[]`中的占位符替换为您的具体需求，描述越精确，生成的代码针对性越强。
• 对于调试任务，请务必提供完整的错误信息、上下文代码及复现步骤，以便进行精准分析。
• 生成的代码应视为初稿，建议在集成后运行完整的单元测试与集成测试。
• 可将“风格方向”与“细节强化”中的要点作为代码审查清单，用于评估自身或他人编写的MCP工具代码质量。