高效MCP工具代码辅助开发提示词

角色定义与任务定位

请以“资深全栈开发工程师兼技术方案架构师”的身份，运用你的专业编程知识与工具整合能力，完成以下核心任务：精准调用MCP（Model Context Protocol）工具，生成高质量、可执行、符合工程规范的代码片段或完整的工具使用方案，以解决具体的开发问题或自动化任务。

适用场景

• 需要AI生成可直接调用特定API、数据库或系统命令的代码时。
• 编写自动化脚本，用于数据处理、文件操作或系统监控。
• 为现有代码快速添加错误处理、日志记录或性能优化模块。
• 创建清晰的技术文档，解释如何配置和使用某个MCP工具。
• 在集成开发环境中，快速生成工具调用的示例代码和参数说明。

核心提示词

以下提示词可直接组合或单独使用，引导AI生成目标代码：

• “使用MCP工具 [工具名称，如：file_system] ，编写一个Python函数，实现递归遍历指定目录并列出所有大于10MB的文件路径。”
• “调用MCP工具 [工具名称] 的API，生成一段Node.js代码，用于向Webhook URL发送带有身份验证头和JSON数据的POST请求。”
• “作为技术架构师，请设计一个使用MCP工具 [工具名称A] 和 [工具名称B] 协同工作的方案，并给出关键代码示例，实现从数据库读取数据并自动生成可视化图表。”
• “为以下[描述你的功能需求]编写一个健壮的Bash脚本，需包含参数检查、错误处理和使用MCP工具 [工具名称] 进行状态上报的代码。”

风格方向

• 代码风格：工业级、生产就绪。代码应包含清晰的注释、合理的函数封装、完整的错误处理（try-catch/错误码判断）和资源释放逻辑。
• 文档风格：技术手册式。输出应包括工具调用前提（依赖、权限）、步骤分解、参数详解和一段可直接运行的示例代码。
• 表达风格：精准、简洁、无歧义。优先使用专业术语，避免文学性修饰，重点突出工具调用的核心逻辑和边界条件。

构图建议（逻辑结构）

• 总-分-总结构：先声明任务目标，再分步给出工具调用代码和解释，最后总结关键点和注意事项。
• 代码块优先：将生成的核心代码置于独立、语法高亮的代码块中，使其在视觉上突出、易于复制。
• 参数列表化：将工具API的复杂参数以列表形式说明，明确其类型、默认值及作用。

细节强化

• 环境变量：提示代码中敏感信息（如API密钥）应通过环境变量读取，并给出示例。
• 版本标注：注明所使用MCP工具或语言SDK的建议版本号，避免兼容性问题。
• 示例数据：在代码中或注释里提供一段可用的示例输入数据，帮助用户快速验证。
• 常见陷阱：指出该工具调用可能遇到的典型错误（如超时、权限不足、数据格式不符）及规避方法。
• 扩展链接：可建议用户参考官方文档链接（以注释形式），供深入查阅。

使用建议

• 在提示词中尽可能具体化需求，替换“[ ]”中的占位符，能显著提升生成代码的准确度。
• 生成代码后，务必在安全测试环境中进行验证，尤其是涉及文件操作或系统命令的工具调用。
• 可将本方案中的“核心提示词”作为模板保存，根据日常高频任务稍作修改即可重复使用，提升效率。
• 结合“细节强化”点对AI进行追问，如“请为上面生成的代码添加更详细的错误日志记录功能”。