mcp-builder

ChuDiRen's avatarfrom ChuDiRen

MCP（Model Context Protocol）服务器开发指南。当用户需要开发 MCP 服务器、创建 LLM 工具集成、或构建 AI 代理与外部服务交互的接口时使用。

⭐2stars🔀0forks📁View on GitHub🕐Updated Dec 26, 2025
[Developer Tools]

When & Why to Use This Skill

This Claude skill serves as a comprehensive development guide for the Model Context Protocol (MCP). It empowers developers to build robust MCP servers, integrate sophisticated LLM tools, and create seamless interfaces for AI agents to interact with external services and data sources using TypeScript or Python.

Use Cases

  • Scenario 1: Building custom MCP servers to connect AI agents with internal enterprise APIs, proprietary databases, or local file systems.
  • Scenario 2: Designing type-safe tool integrations for LLMs, ensuring structured communication and reliable execution of complex tasks.
  • Scenario 3: Streamlining the development lifecycle of AI agents by utilizing standardized project structures and interactive debugging tools like the MCP Inspector.
namemcp-builder
descriptionMCP（Model Context Protocol）服务器开发指南。当用户需要开发 MCP 服务器、创建 LLM 工具集成、或构建 AI 代理与外部服务交互的接口时使用。

MCP Builder - MCP 服务器开发指南

概述

MCP 服务器使 LLM 能够通过设计良好的工具与外部服务交互。

技术栈选择

技术栈 推荐度 理由
TypeScript ⭐⭐⭐⭐⭐ SDK 支持好、类型安全
Python ⭐⭐⭐⭐ 生态丰富、易于上手

传输协议：

  • Streamable HTTP：推荐用于远程服务器
  • stdio：适用于本地工具

开发流程

阶段1：研究与规划

规划清单：
1. 目标服务的 API 文档在哪里？
2. 需要实现哪些核心功能？
3. 哪些是只读操作？哪些是写操作？
4. 需要什么认证方式？

阶段2：实现

TypeScript 项目结构：

my-mcp-server/
├── src/
│   ├── index.ts
│   ├── server.ts
│   ├── tools/
│   └── utils/
├── package.json
└── tsconfig.json

Python 项目结构：

my-mcp-server/
├── src/my_mcp_server/
│   ├── __init__.py
│   ├── server.py
│   ├── tools/
│   └── utils/
└── pyproject.toml

阶段3：测试

使用 MCP Inspector 进行交互式测试：

npx @anthropic-ai/mcp-inspector

工具注解

注解 说明
readOnlyHint 只读操作
destructiveHint 破坏性操作
idempotentHint 幂等操作

最佳实践

  • 单一职责：每个工具只做一件事
  • 清晰命名：使用动词+名词格式
  • 完整描述：包含用途、参数、返回值说明
  • 统一错误处理：所有错误使用相同格式
  • 分页支持：大数据集必须支持分页

参考资源