القائمة
MCP（Model Context Protocol）服务器构建原则。工具设计、资源模式与最佳实践。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
务实的编码标准—— 简洁、直接、不做过度设计、不写无用注释（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 依赖描述来正确调用它们。