Menü
MCP（Model Context Protocol）服务器构建原则。工具设计、资源模式与最佳实践。
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Basierend auf der SOC-Berufsklassifikation
务实的编码标准—— 简洁、直接、不做过度设计、不写无用注释（Pragmatic coding standards）
性能分析原则。测量、分析与优化技术。
API design principles and decision-making（API 设计原则与决策逻辑）。REST vs GraphQL vs tRPC selection（选择）、response formats（响应格式）、versioning（版本控制）、pagination（分页）。
App Builder（应用构建编排器）主编排器。根据自然语言请求创建全栈应用，确定项目类型、选择技术栈并协调智能体。
Project scaffolding templates（项目脚手架模板）。用于从零创建新项目。包含 12 个技术栈模板。
Architectural decision-making framework（架构决策框架）。Requirements analysis（需求分析）、trade-off evaluation（权衡评估）、ADR documentation（架构决策记录）。Use when making architecture decisions or analyzing system design（用于架构决策与系统设计分析）。
| name | mcp-builder |
| description | MCP（Model Context Protocol）服务器构建原则。工具设计、资源模式与最佳实践。 |
| allowed-tools | Read, Write, Edit, Glob, Grep |
MCP 服务器构建原则。
Model Context Protocol：用于连接 AI 系统与外部工具、数据源的标准协议。
| 概念 | 目的 |
|---|---|
| Tools | AI 可调用的函数能力 |
| Resources | AI 可读取的数据资源 |
| Prompts | 预定义提示词模板 |
my-mcp-server/
+-- src/
| +-- index.ts # 主入口
+-- package.json
+-- tsconfig.json
| 类型 | 用途 |
|---|---|
| Stdio | 本地、CLI 场景 |
| SSE | Web 场景、流式输出 |
| WebSocket | 实时、双向通信 |
| 原则 | 描述 |
|---|---|
| 名称清晰 | 动作导向（get_weather, create_user） |
| 单一职责 | 一次只做好一件事 |
| 输入可校验 | 使用含类型与描述的 schema |
| 输出结构化 | 响应格式可预测 |
| 字段 | 必填？ |
|---|---|
| Type | 是（object） |
| Properties | 定义每个参数 |
| Required | 列出必填参数 |
| Description | 人类可读说明 |
| 类型 | 用途 |
|---|---|
| Static | 固定数据（配置、文档） |
| Dynamic | 按请求动态生成 |
| Template | 含参数的 URI 模板 |
| 模式 | 示例 |
|---|---|
| Fixed | docs://readme |
| Parameterized | users://{userId} |
| Collection | files://project/* |
| 情况 | 响应 |
|---|---|
| 参数无效 | 返回明确的校验错误 |
| 资源不存在 | 返回清晰的 “not found” |
| 服务器错误 | 返回通用错误并记录日志 |
| 类型 | 编码 |
|---|---|
| Text | Plain text |
| Images | Base64 + MIME type |
| Files | Base64 + MIME type |
| 字段 | 目的 |
|---|---|
| command | 要执行的命令 |
| args | 命令参数 |
| env | 环境变量 |
| 类型 | 关注点 |
|---|---|
| Unit | 工具逻辑 |
| Integration | 服务整体 |
| Contract | Schema 校验 |
记住： MCP 工具应保持简单、聚焦且文档完善。AI 依赖描述来正确调用它们。