Back to Details

agency-mcp-builder

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

MCP Builder

MCP 构建器

Use this skill when the job is to design or implement an MCP server, not just discuss one.
当任务是设计或实现MCP服务器（而非仅进行讨论）时，使用此技能。

Best for

适用场景

  • Planning a narrow MCP tool surface for an agent workflow
  • Implementing or upgrading MCP servers
  • Defining tool/resource contracts before writing code
  • Auditing MCP server ergonomics, validation, and failure modes
  • 为Agent工作流规划精简的MCP工具接口
  • 实现或升级MCP服务器
  • 在编写代码前定义工具/资源契约
  • 审核MCP服务器的易用性、验证机制和故障模式

Workflow

工作流程

  1. Start from the user outcome or agent workflow.
  2. Define the minimum viable tool surface before implementation.
  3. For each tool, specify:
    • name
    • description
    • input schema
    • return shape
    • failure cases
  4. Decide what belongs in:
    • tools
    • resources
    • prompts
  5. Choose transport last, after the contract is clear.
  6. Validate with at least one realistic usage path.
  1. 从用户目标或Agent工作流出发。
  2. 在实现前定义最小可行的工具接口。
  3. 针对每个工具，明确：
    • 名称
    • 描述
    • 输入 schema
    • 返回格式
    • 故障场景
  4. 确定内容归属：
    • 工具
    • 资源
    • 提示词
  5. 在契约明确后，最后选择传输层方案。
  6. 至少通过一条真实的使用路径进行验证。

Output contract

输出契约

Produce:
  • a tool plan
  • implementation approach
  • security and auth notes
  • test strategy
  • rollout or migration notes if applicable
需生成：
  • 工具规划方案
  • 实现思路
  • 安全与认证说明
  • 测试策略
  • 适用时的部署或迁移说明

Critical rules

核心规则

  1. Descriptive tool names — 
    search_users
    not 
    query1
    ; agents pick tools by name
  2. Schema first — Every tool input validated, optional params have defaults
  3. Structured output — Return machine-usable data and readable errors
  4. Fail gracefully — Never leak raw stack traces to clients
  5. Stateless by default — Do not rely on call order unless explicitly designed that way
  6. Small v1 — Prefer 3-5 sharp tools over a broad vague surface
  1. 具描述性的工具名称 — 使用
    search_users
    而非
    query1
    ；Agent会通过名称选择工具
  2. Schema优先 — 每个工具输入均需验证，可选参数需设置默认值
  3. 结构化输出 — 返回机器可处理的数据和易读的错误信息
  4. 优雅容错 — 绝不向客户端泄露原始堆栈跟踪信息
  5. 默认无状态 — 除非明确设计，否则不要依赖调用顺序
  6. 精简V1版本 — 优先选择3-5个精准工具，而非宽泛模糊的工具接口

Starter prompts

初始提示词示例

  • Plan an MCP server for this workflow. Start with the smallest useful tool surface and specify tool contracts before implementation.
  • Audit this MCP server for poor tool names, weak schemas, auth gaps, and confusing outputs.
  • Implement an MCP server for 
    <use case>
    with typed inputs, clear failures, and a realistic test path.
  • 为此工作流规划一个MCP服务器。从最小可用的工具接口入手，在实现前明确工具契约。
  • 审核此MCP服务器，检查是否存在工具名称不佳、Schema薄弱、认证漏洞以及输出混乱的问题。
  • 为
    <使用场景>
    实现一个具备类型化输入、清晰故障提示和真实测试路径的MCP服务器。

Autonomous decision rules

自主决策规则

Use this skill when:
  • the task mentions MCP servers, tools, resources, prompts, or agent connectors
  • the user needs agent capabilities exposed through a protocol boundary
Do NOT use when:
  • the task is only general API design with no MCP surface
  • the user only needs product planning and no protocol/tool design
使用此技能的场景：
  • 任务涉及MCP服务器、工具、资源、提示词或Agent连接器
  • 用户需要通过协议边界暴露Agent能力
请勿使用此技能的场景：
  • 任务仅为通用API设计，不涉及MCP接口
  • 用户仅需产品规划，无需协议/工具设计