内容
# MCP Server 模板
一个用于构建 MCP (Model Context Protocol) 服务器的最小 TypeScript 模板。
## 特性
- **Vibe 编码准备就绪**:预先组织的目录结构,包含完整的规则和示例
- **实现指南**:完整的 CLAUDE.md,包含模式和示例
## 快速开始
```bash
# 安装依赖
npm install
# 构建服务器
npm run build
# 启动服务器
npm run start
```
## 示例工具
该模板包含一个 `example` 工具,演示:
## 添加新工具
1. 在 `src/mcp/tool/your-tool/` 中创建一个新目录
2. 添加以下文件:
- `schema.ts` - 输入/输出模式
- `handler.ts` - 工具逻辑
- `index.ts` - 工具导出
3. 在 `src/mcp/Server.ts` 中注册该工具
## 文件结构
```
src/
├── index.ts # 服务器入口点
├── mcp/ # MCP 服务器层
│ ├── Server.ts # MCP 服务器设置
│ └── tool/
│ ├── util.ts # 响应工具
│ ├── example/ # 示例工具
│ │ ├── schema.ts # Zod 模式
│ │ ├── handler.ts # 工具处理器
│ │ └── index.ts # 工具导出
│ └── CLAUDE.md # 实现指南
├── domain/ # 领域层(可选)
│ ├── command/ # 命令聚合
│ │ └── your-aggregate/
│ │ ├── aggregate.ts # 业务逻辑
│ │ └── events.ts # 领域事件
│ ├── read/ # 读取模型
│ │ └── your-view/
│ │ ├── index.ts # 查询函数
│ │ └── types.ts # 视图类型
│ └── term/ # 领域术语
│ └── types.ts # 共享领域类型
└── effect/ # 效果层(可选)
└── storage/
└── your-storage.ts # 副作用
```