MCP Builder

构建高质量 MCP(模型上下文协议)服务器的指南,使 LLM 能够通过精心设计的工具与外部服务交互。在使用 Python (FastMCP) 或 Node/TypeScript (MCP SDK) 构建 MCP 服务器以集成外部 API 或服务时使用。

617 stars 96 forksAI, LLMs & Agents

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add LeastBit/Claude_skills_zh-CN --skill mcp-builder
Manual install
git clone --depth 1 https://github.com/LeastBit/Claude_skills_zh-CN.git /tmp/Claude_skills_zh-CN
mkdir -p ~/.claude/skills
cp -r /tmp/Claude_skills_zh-CN/skills/mcp-builder ~/.claude/skills/mcp-builder

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# MCP 服务器开发指南

## 概述

创建 MCP(模型上下文协议)服务器,使 LLM 能够通过精心设计的工具与外部服务交互。MCP 服务器的质量取决于它能多好地使 LLM 完成实际任务。

---

# 流程

## 🚀 高级工作流程

创建高质量的 MCP 服务器包含四个主要阶段:

### 阶段一:深入研究与规划

#### 1.1 理解现代 MCP 设计

**API 覆盖 vs. 工作流工具:**
在全面的 API 端点覆盖与专用工作流工具之间取得平衡。工作流工具对于特定任务可能更方便,而全面覆盖则给予代理灵活组合操作的能力。不同客户端的性能表现各异——某些客户端受益于结合基本工具的代码执行,而另一些则更适合使用高级工作流。当不确定时,优先考虑全面的 API 覆盖。

**工具命名与可发现性:**
清晰、描述性的工具名称有助于代理快速找到正确的工具。使用一致的前缀(例如 `github_create_issue`、`github_list_repos`)和面向动作的命名。

**上下文管理:**
代理受益于简洁的工具描述以及过滤/分页结果的能力。设计返回聚焦、相关数据的工具。某些客户端支持代码执行,这可以帮助代理高效地过滤和处理数据。

**可操作的错误消息:**
错误消息应引导代理找到解决方案,提供具体的建议和下一步操作。

#### 1.2 学习 MCP 协议文档

**浏览 MCP 规范:**

从站点地图开始查找相关页面:`https://modelcontextprotocol.io/sitemap.xml`

然后使用 `.md` 后缀获取特定页面的 markdown 格式(例如 `https://modelcontextprotocol.io/specification/draft.md`)。

需要查阅的关键页面:
- 规范概述和架构
- 传输机制(流式 HTTP、stdio)
- 工具、资源和提示定义

#### 1.3 学习框架文档

**推荐技术栈:**
- **语言**:TypeScript(高质量 SDK 支持,在许多执行环境中兼容性良好,如 MCPB。此外 AI 模型擅长生成 TypeScript 代码,得益于其广泛使用、静态类型和良好的 lint 工具)
- **传输**:远程服务器使用流式 HTTP,采用无状态 JSON(相比有状态会话和流式响应,更易于扩展和维护)。本地服务器使用 stdio。

**加载框架文档:**

- **MCP 最佳实践**:[📋 查看最佳实践](./reference/mcp_best_practices.md) - 核心指南

**TypeScript(推荐):**
- **TypeScript SDK**:使用 WebFetch 加载 `https://raw.githubusercontent.com/modelcontextprotocol/typescript-sdk/main/README.md`
- [⚡ TypeScript 指南](./reference/node_mcp_server.md) - TypeScript 模式和示例

**Python:**
- **Python SDK**:使用 WebFetch 加载 `https://raw.githubusercontent.com/modelcontextprotocol/python-sdk/main/README.md`
Read the full skill on GitHub

Details

Skill name
mcp-builder
Path
skills/mcp-builder/SKILL.md
Repo updated
19 January 2026

FAQ

What does the MCP Builder skill do?

构建高质量 MCP(模型上下文协议)服务器的指南,使 LLM 能够通过精心设计的工具与外部服务交互。在使用 Python (FastMCP) 或 Node/TypeScript (MCP SDK) 构建 MCP 服务器以集成外部 API 或服务时使用。

How do I install the MCP Builder skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add LeastBit/Claude_skills_zh-CN --skill mcp-builder. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is MCP Builder popular?

It lives in LeastBit/Claude_skills_zh-CN, which has 617 GitHub stars and 96 forks.

Related skills

Skill Creator

617

LeastBit/Claude_skills_zh-CN

创建高效技能的指南。当用户想要创建新技能(或更新现有技能)以扩展 Claude 的能力,包括专业知识、工作流程或工具集成时,应使用此技能。

Skill & Plugin Authoring96

Algorithmic Art

617

LeastBit/Claude_skills_zh-CN

使用 p5.js 创建带有种子随机性和交互式参数探索的算法艺术。当用户请求使用代码创建艺术、生成艺术、算法艺术、流场或粒子系统时使用此技能。创作原创算法艺术,而不是复制现有艺术家的作品,以避免版权侵犯。

Images, Video & Audio96

Brand Guidelines

617

LeastBit/Claude_skills_zh-CN

将 Anthropic 官方品牌颜色和字体应用于任何可能需要 Anthropic 视觉风格的作品。适用于品牌颜色或样式指南、视觉格式化或公司设计标准的场景。

Frontend & Design96

Agent Md Advisor

757

chujianyun/skills

AGENTS.md / CLAUDE.md 最佳实践顾问。用于用户询问 agents markdown、AGENTS.md、CLAUDE.md、Claude Code memory、AI coding agent 指令文件的格式、结构、最佳实践;也用于审查、诊断、重写、优化或从零创建 AGENTS.md、CLAUDE.md、CLAUDE.local.md、.claude/rules 等 agent 指令文件。不适用于通用 README 写作,除非目标是给 AI coding agent 提供项目上下文。

AI, LLMs & Agents102

Internal Comms

617

LeastBit/Claude_skills_zh-CN

一套帮助我撰写各类内部沟通文档的资源,使用公司偏好的格式。当被要求撰写任何形式的内部沟通文档(状态报告、领导层更新、3P 更新、公司简报、常见问题解答、事件报告、项目更新等)时,Claude 应使用此技能。

AI, LLMs & Agents96

Agent Optimizer

757

chujianyun/skills

Agent 设计顾问与审查工具。基于 12-Factor AgentOps 最佳实践,用于:(1) 探讨 Agent 架构设计方案;(2) 审查现有 Agent/Skill/工作流的设计,发现问题,给出改进建议。触发词:审查我的 agent、帮我分析这个 skill、agent 设计、agent 优化、帮我 review 这个工作流、这个 agent 有什么问题、怎么设计 agent、agent 架构咨询。

AI, LLMs & Agents102

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.