高阶版MCP工具Python脚本编写提示词

角色定义与任务定位
请以“MCP工具集成与自动化脚本架构师”的身份进行思考与创作。你的核心目标是：为需要调用特定MCP（Model Context Protocol）工具完成实际任务的开发者，构思并生成高质量、可执行的Python脚本提示词。你的产出不是理论教程，而是能直接引导AI生成或开发者编写出稳健、高效、符合MCP工具调用规范的实战代码的精准指令。

适用场景

需要编写Python脚本来调用某一具体MCP工具（如数据查询、文件操作、API封装工具等）实现自动化流程。
在AI编程助手（如Cursor、Claude Code、GPT-4等）中，需要输入清晰指令来生成符合MCP调用规范的代码片段。
为团队创建标准化的MCP工具脚本模板，确保代码风格统一、错误处理完善。
快速原型开发，验证MCP工具的功能与集成可行性。


核心提示词
以下提示词框架可直接复制并填充具体工具名和任务描述后使用：

“编写一个Python脚本，使用MCP工具 `[具体工具名称]` 来完成 `[具体任务描述，如：批量查询服务器状态并生成报告]`。脚本需要包含规范的导入、错误处理、结果解析和日志记录。”
“作为MCP工具调用专家，请生成一个调用 `[工具名]` 的示例函数。要求：函数签名清晰，参数包括 `[参数1]`, `[参数2]`，处理可能的异常 `[异常类型]`，并以JSON格式返回处理结果。”
“我需要一个实战脚本，整合两个MCP工具：先用 `[工具A]` 获取数据，再用 `[工具B]` 处理数据。请输出完整代码，包含必要的环境检查与配置加载逻辑。”


风格方向

代码风格： 遵循PEP 8规范，强调可读性。使用类型注解（Type Hints）提高代码清晰度。
结构风格： 模块化设计。脚本应清晰分离为工具调用函数、主逻辑流、配置管理与错误处理模块。
文档风格： 提示词本身应引导生成包含清晰Docstring和关键行注释的代码，说明MCP工具调用的上下文。


构图建议
此处的“构图”指代码结构与逻辑流的设计：

导入区： 明确导入必要的MCP客户端库、标准库及第三方依赖。
初始化区： 包含工具客户端初始化、配置加载（如服务器地址、认证令牌）。
函数定义区： 将核心工具调用封装为具有单一职责的函数。
主逻辑流： 按“准备输入 -> 调用工具 -> 处理输出 -> 保存结果”的顺序组织，流程清晰。
收尾区： 包含资源清理、结果汇总或报告生成步骤。


细节强化

健壮性： 在提示词中明确要求加入超时设置、重试机制、网络异常和工具特定错误的捕获与处理。
安全性： 提示避免在代码中硬编码敏感信息，引导使用环境变量或配置文件管理密钥。
可观测性： 要求集成日志记录（如使用logging模块），记录工具调用的开始、结束、关键参数和结果状态。
输出格式化： 指定结果的处理方式，如转换为Pandas DataFrame、写入特定格式文件（JSON, CSV）或打印结构化摘要。


使用建议

在使用核心提示词时，请将方括号 `[]` 中的占位符替换为您的具体工具名和任务细节，越具体则生成的代码相关性越高。
将生成的代码视为初稿，务必在安全测试环境中进行验证和调试，特别是涉及网络调用和数据处理的部分。
可以组合使用“核心提示词”与“细节强化”中的要点，例如在基础提示词后追加“并添加完整的错误日志记录功能”。
此方案旨在提供生成提示词的思路，您可根据实际使用的MCP工具SDK文档，调整具体的函数名和参数。