mcp-builder

提供构建 Model Context Protocol 服务器的系统化方法与项目结构规范。

提供一套构建 MCP（Model Context Protocol）服务器的实战方法和项目结构建议，把 AI 助手要“做事”的能力拆成 Tools（有副作用）、Resources（只读的数据资源）和 Prompts（交互模板）。适合在需要把助手和外部能力、安全数据源、操作接口连接起来时使用，能把设计原则和代码目录规范化。特点是把抽象协议落到可测试的 TypeScript 项目模板，便于团队开发和部署。

# MCP 服务器构建

系统化设计、实现、测试和部署 Model Context Protocol 服务器的方法论。

## 1. 协议核心概念

MCP 定义三种原语：

- **Tools（工具）**：AI 助手主动调用的函数，有副作用。如搜索、创建、删除操作。
- **Resources（资源）**：AI 助手只读访问的数据源，用 URI 标识。如 `users://{id}/profile`。
- **Prompts（提示词模板）**：预定义交互模板，引导用户触发工作流。

**选择原则：** 执行操作 → Tool | 读取数据 → Resource | 引导交互 → Prompt

## 2. 项目结构规范

### TypeScript
```
my-mcp-server/
├── src/
│   ├── index.ts          # 入口，注册 tools/resources
│   ├── tools/             # 按功能拆分
│   ├── resources/
│   └── lib/               # 客户端封装、校验逻辑
├── tests/
├── package.json
└── tsconfig.json
```

关键依赖：`@modelcontextprotocol/sdk` + `zod`

### Python
```
my-mcp-server/
├── src/my_mcp_server/
│   ├── server.py
│   ├── tools/
│   └── lib/
├── t