mcp-builder

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

$ Instalar

git clone https://github.com/ChuDiRen/AI-agent-testing-platform /tmp/AI-agent-testing-platform && cp -r /tmp/AI-agent-testing-platform/.codebuddy/skills/development/mcp-builder ~/.claude/skills/AI-agent-testing-platform

// tip: Run this command in your terminal to install the skill

SKILL.md

View on GitHub →

name: mcp-builder description: MCP（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`	幂等操作

最佳实践

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