高质量MCP工具代码生成调试提示词

角色定义与任务定位
请以“资深MCP工具架构师与代码质量工程师”的身份，运用此提示词方案。你的核心目标是：系统化地生成符合MCP协议规范、逻辑严谨且可维护性高的工具代码，并构建一套高效的自动化调试与验证流程，确保输出代码的健壮性与生产就绪性。
适用场景

为特定功能或API接口快速生成MCP工具（Server）的初始代码框架。
为已有的MCP工具代码生成配套的单元测试、集成测试用例。
对存在运行时错误、逻辑缺陷或性能瓶颈的MCP工具代码进行诊断与修复。
生成代码注释、API文档或使用示例，提升代码的可读性与易用性。

核心提示词

生成基础工具：Generate a Model Context Protocol (MCP) server tool in [Python/TypeScript] for [具体功能，如：fetching real-time weather data]. Implement the necessary handlers, input validation, and error handling following MCP specifications.
生成测试代码：Write comprehensive unit tests for the following MCP tool code. Cover edge cases, mock external dependencies, and ensure the `execute` method behaves correctly under various inputs.
调试与修复：Debug this MCP tool code. Identify the cause of the error “[错误描述或现象]”, provide a fix, and explain the root cause. Focus on [可能领域，如：resource lifecycle, async/await handling, JSON schema mismatch].
优化与重构：Refactor the given MCP tool to improve [可维护性/性能/安全性]. Suggest and implement changes such as [代码复用、配置化、更高效的算法或缓存策略].

风格方向

代码风格：遵循所在语言的主流社区规范（如PEP 8 for Python, Airbnb Style Guide for TypeScript），保持命名清晰、函数职责单一。
架构风格：模块化设计，工具定义（`tools`）与实现逻辑分离，便于扩展和维护。
文档风格：内联文档（Docstrings）清晰说明工具用途、参数、返回值及示例；错误信息应具备可读性和可操作性。

构图建议（逻辑结构）

整体框架：采用“导入依赖 → 定义工具Schema（名称、描述、参数） → 实现核心逻辑函数 → 包装为MCP Handler → 错误处理与资源清理”的清晰流。
逻辑分层：将业务逻辑、数据访问、协议适配层分离，避免代码耦合。
测试结构：采用“准备（Arrange）- 执行（Act）- 断言（Assert）”模式组织测试用例。

细节强化

输入验证：强制使用JSON Schema或Pydantic/TypeScript接口严格定义和校验输入参数。
错误处理：使用结构化的错误类型（如自定义异常），向上层返回包含错误码和友好信息的标准化错误对象。
资源管理：对于涉及网络连接、文件操作的工具，确保使用`try…finally`或`async with`进行可靠的资源释放。
日志与可观测性：在关键步骤添加结构化日志，便于运行时监控和问题追踪。

使用建议

将“核心提示词”中的占位符（如`[Python/TypeScript]`、`[具体功能]`）替换为你的实际需求，即可直接用于AI代码生成。
迭代使用：首先生成基础代码，随后使用“生成测试代码”提示词创建测试，最后用“调试与修复”提示词进行验证与优化。
在生成或调试后，可追加“添加详细的代码注释”或“生成一个使用示例”等指令，以完善交付物。
本方案关键词同样适用于对现有代码进行审查和优化，只需将代码片段作为上下文提供给AI。