结构化MCP工具自建Agent方案提示词

角色定义与任务定位

请以“MCP工具架构师”的身份，运用结构化思维与工程化方法，完成以下核心任务：将“自建Agent”这一抽象目标，拆解为一份清晰、可执行、模块化的构建方案。你的产出不是概念阐述，而是可直接用于指导开发或与大模型（如Claude、GPT等）协作生成具体代码、配置与流程的“施工图”。

适用场景

• 为特定垂直领域（如数据分析、自动化运维、智能客服）设计专属的MCP Agent。
• 将现有工具链或API服务，通过MCP协议封装成标准化、可复用的智能体模块。
• 在团队内部建立统一的Agent开发规范与方案模板，提升协作效率。
• 作为提示词核心，引导AI助手生成MCP Server的代码框架、配置说明或部署文档。

核心提示词

（以下提示词可直接复制，用于初始化你的Agent构建对话或作为方案提纲）

• “作为MCP工具架构师，请为我设计一个用于[你的具体场景，如：监控告警分析]的自建Agent方案。方案需严格遵循结构化要求，首先明确Agent的核心职能与边界，然后输出包括协议适配层、工具集（Tools）定义、上下文管理逻辑、错误处理机制在内的模块设计。请给出关键代码接口描述或伪代码示例。”
• “基于MCP协议，结构化构建一个具备[具体能力，如：多步骤推理、外部API调用]的Agent。请列出必需的组件清单、数据流图，并详细说明各模块间的交互协议与状态传递方式。”
• “生成一份《[Agent名称] MCP Agent实战应用方案》，内容需涵盖：1. 问题定义与价值主张；2. 系统架构图与组件说明；3. 核心工具（Tools）的输入/输出规范；4. 与主模型（如Claude Desktop）的集成配置步骤；5. 测试与迭代建议。”

风格方向

• 工程蓝图风格：侧重技术架构图、序列图、接口定义（IDL）、模块清单。语言精确、逻辑严密，像一份技术设计文档。
• 实战手册风格：以“第一步、第二步…”的步骤式讲解为核心，穿插代码片段、配置示例和常见问题排查（Troubleshooting）。语言直接，面向动手实践。
• 方案提案风格：结构清晰，包含背景、目标、实施方案、资源评估、成功指标。语言兼具说服力与专业性，适用于团队评审或项目立项。

构图建议

• 若需视觉化呈现方案，建议构图元素：分层架构图（展示MCP Server、Tools、资源、主模型等层级）、数据流向箭头、核心模块高亮标注、代码卡片悬浮展示。
• 色彩上，可采用深蓝/灰色系体现专业与稳定，用亮色（如绿色、橙色）突出关键组件或数据路径。
• 整体布局应整洁、有层次，避免元素堆砌。可想象为一张专业的系统架构海报或技术幻灯片。

细节强化

• 在工具（Tools）定义部分，必须明确：name, description, inputSchema（JSON Schema格式）。这是MCP协议的核心。
• 强调“结构化”：方案应自带目录、编号系统、清晰的标题层级，使读者能快速定位到架构概述、工具列表、部署步骤等任何部分。
• 融入“实战应用”考量：包含简易的本地运行示例命令（如使用`npx`）、环境变量配置说明、如何通过Claude Desktop进行调试等贴近实际操作的细节。
• 材质与氛围：描述方案文档的质感如同打磨过的产品说明书，逻辑严密如电路板，可执行步骤如清晰的乐高搭建手册。

使用建议

• 将“核心提示词”部分的内容直接发送给你选择的AI编码助手（如Claude、Cursor等），作为生成具体代码和配置的起点。
• 根据你的具体场景，替换提示词中的“[ ]”占位符，使其目标更明确。场景越具体，生成的方案越具可操作性。
• 结合“风格方向”选择你需要的输出调性，并在给AI的指令中明确指出，例如：“请以‘实战手册风格’生成以下方案…”。
• 生成的方案初稿后，可进一步要求AI为特定模块（如“错误处理机制”）深化，或转换为特定格式（如Markdown文档、PlantUML代码）。