提示词模板 / Agent

MCP Server 定义编写

为 Model Context Protocol 编写 server 的 tools/resources 定义与说明文档,让 Claude 等客户端能稳定发现并调用。

Agent适合:两者皆可3 个变量

适用场景

  • 要把内部系统暴露给支持 MCP 的客户端
  • 已有 HTTP API,想包装成 MCP server
  • 不确定 tools、resources、prompts 三者该怎么分

你会得到

  • tools / resources / prompts 划分建议
  • 每个工具的 JSON Schema
  • 错误码与鉴权设计
  • 客户端配置片段

避坑提示

  • 把「读数据」也做成 tool——读类操作更适合 resources
  • 返回内容不做截断,一次吐几万字符把上下文撑爆
  • 不给错误语义(失败时返回什么),Agent 无法恢复

填入变量,生成提示词

0 / 3 已填
你是 MCP(Model Context Protocol)实现专家。请为下面的系统设计 MCP server。

【要暴露的系统】
【要暴露的系统/能力】

【目标客户端】
【目标客户端】

【鉴权与限制】
【鉴权与限制】

请输出:

## 1. 能力划分
先判断哪些应该是 tools(有副作用 / 需要参数化执行),哪些应该是 resources(可按 URI 读取的静态或半静态数据),哪些适合 prompts(预设模板)。给出理由。

## 2. tools 定义
每个工具输出 JSON Schema,包含:
- name(snake_case,动词开头)
- description:做什么 / 什么时候用 / 什么时候不要用 / 返回值是什么
- inputSchema:每个参数的 type、description、是否必填、取值范围、示例
- 明确的副作用标注(是否写操作)

## 3. resources 定义
- URI 模板(如 ticket://{id})
- mimeType
- 返回体结构,以及**截断策略**(单条最大字符数、列表最大条数)

## 4. 错误处理
定义统一的错误返回结构(code / message / retryable),并列出必须区分的关键错误:
鉴权失败、资源不存在、限流、参数非法、下游超时。

## 5. 客户端配置
给出 【目标客户端】 的配置片段(启动命令 / 传输方式 stdio 或 http)。

【红线】
- 不要把写操作伪装成查询
- 不要设计返回体无上限的工具

未填的变量会保留为 【变量名】 占位,方便你确认哪里还没补。点击上方按钮复制后粘贴到模型即可。

查看原始模板(含变量占位符)
你是 MCP(Model Context Protocol)实现专家。请为下面的系统设计 MCP server。

【要暴露的系统】
{{系统}}

【目标客户端】
{{客户端}}

【鉴权与限制】
{{约束}}

请输出:

## 1. 能力划分
先判断哪些应该是 tools(有副作用 / 需要参数化执行),哪些应该是 resources(可按 URI 读取的静态或半静态数据),哪些适合 prompts(预设模板)。给出理由。

## 2. tools 定义
每个工具输出 JSON Schema,包含:
- name(snake_case,动词开头)
- description:做什么 / 什么时候用 / 什么时候不要用 / 返回值是什么
- inputSchema:每个参数的 type、description、是否必填、取值范围、示例
- 明确的副作用标注(是否写操作)

## 3. resources 定义
- URI 模板(如 ticket://{id})
- mimeType
- 返回体结构,以及**截断策略**(单条最大字符数、列表最大条数)

## 4. 错误处理
定义统一的错误返回结构(code / message / retryable),并列出必须区分的关键错误:
鉴权失败、资源不存在、限流、参数非法、下游超时。

## 5. 客户端配置
给出 {{客户端}} 的配置片段(启动命令 / 传输方式 stdio 或 http)。

【红线】
- 不要把写操作伪装成查询
- 不要设计返回体无上限的工具

同类模板

← 返回提示词模板