什么是 MCP Builder？

MCP Builder 是一个 Claude Code 技能（Skill），专门用于指导开发者构建高质量的 Model Context Protocol (MCP) 服务器。MCP 服务器能让大语言模型（LLM）通过精心设计的工具与外部服务进行交互。

该技能来自 awesome-claude-skills 仓库，拥有 27.6k+ Stars。

步骤 1：克隆技能仓库

# 克隆整个 awesome-claude-skills 仓库
git clone https://github.com/ComposioHQ/awesome-claude-skills.git

# 或者只获取 mcp-builder 目录
cd ~/.claude/skills
git clone --depth 1 --filter=blob:none --sparse \
  https://github.com/ComposioHQ/awesome-claude-skills.git
cd awesome-claude-skills
git sparse-checkout set mcp-builder

步骤 2：安装到 Claude Code

将技能文件复制到 Claude Code 的技能目录：

# 创建技能目录（如果不存在）
mkdir -p ~/.claude/skills

# 复制 mcp-builder 技能
cp -r awesome-claude-skills/mcp-builder ~/.claude/skills/

步骤 3：安装 Python 依赖（可选）

如果需要运行评估脚本，安装以下依赖：

# 进入脚本目录
cd ~/.claude/skills/mcp-builder/scripts

# 安装依赖
pip install -r requirements.txt

依赖包：anthropic>=0.39.0 和 mcp>=1.1.0

命名约定

服务器遵循 {service}_mcp 模式（如 github_mcp、slack_mcp）。

工具命名

使用 snake_case 并带有服务上下文前缀，避免命名冲突：

# ✅ 正确
slack_send_message
github_create_issue

# ❌ 错误
send_message  # 可能与其他服务冲突
createIssue   # 应使用 snake_case

输入验证 (Pydantic)

from pydantic import BaseModel, ConfigDict, Field

class SendMessageInput(BaseModel):
    model_config = ConfigDict(
        str_strip_whitespace=True,  # 自动去除空白
        validate_assignment=True,   # 赋值时验证
        extra='forbid'              # 禁止额外字段
    )

    channel: str = Field(..., min_length=1, description="频道 ID")
    message: str = Field(..., min_length=1, max_length=4000)

命名约定

服务器遵循 {service}-mcp-server 模式。

推荐目录结构

slack-mcp-server/
├── src/
│   ├── index.ts       # 主入口
│   ├── tools/         # 工具实现
│   ├── services/      # API 客户端
│   └── schemas/       # Zod 验证模式
├── package.json
└── tsconfig.json

输入验证 (Zod)

import { z } from 'zod';

const SendMessageSchema = z.object({
    channel: z.string().min(1).describe("频道 ID"),
    message: z.string().min(1).max(4000).describe("消息内容")
}).strict();  // 禁止额外字段

评估标准

评估质量取决于"这些实现如何使 LLM 在没有其他上下文且仅能访问 MCP 服务器的情况下回答真实且困难的问题"。

• 10 个问题，每个问题有单一可验证的答案
• 仅只读操作 — 无破坏性或状态修改操作
• 独立问题 — 不依赖先前的答案
• 稳定答案 — 不会随时间变化
• 复杂多步推理 — 可能需要几十次工具调用

connections.py — MCP 连接处理

提供三种连接类型的轻量级连接管理：

• Stdio — 通过标准输入/输出管理本地进程
• SSE — 通过服务器发送事件连接远程服务器
• HTTP — 通过可流式 HTTP 协议通信

# 使用示例
connection = create_connection(
    transport="stdio",
    command="python",
    args=["my_server.py"]
)

async with connection:
    tools = await connection.list_tools()
    result = await connection.call_tool("my_tool", {"arg": "value"})