create-advanced-mcp-server

一个 CLI 工具，用于搭建一个带有 Web 功能的 Model Context Protocol（MCP）服务器，提供完整的项目结构。

此包根据 MCP 高级节点规范文档中记录的架构创建一个完整的 MCP 服务器项目，为 MCP 服务器开发提供了强大的基础。

特性

• 生成完整的 MCP 服务器项目结构
• 可配置选项，支持 Web API、WebSocket 和数据库集成
• 基于 TypeScript，使用现代 ES 模块
• 提供 Prisma ORM 集成（可选）
• 基于 Express 的 Web API（可选）
• WebSocket 服务器集成（可选）
• 示例实现工具、资源和提示
• 完整的错误处理和日志记录基础设施
• 支持环境变量配置的配置系统

安装

npm install -g create-advanced-mcp-server

使用方法

# 通过交互式提示创建新项目
npx create-advanced-mcp-server my-mcp-server

# 使用默认选项创建新项目
npx create-advanced-mcp-server my-mcp-server --yes

# 跳过依赖安装
npx create-advanced-mcp-server my-mcp-server --skip-install

# 显示详细输出
npx create-advanced-mcp-server my-mcp-server --verbose

生成的项目结构

生成的项目遵循 MCP 高级节点规范中概述的结构：

src/
├── index.ts                  # 入口文件
├── initialize.ts             # 初始化逻辑
├── config.ts                 # 配置管理
├── types.ts                  # 类型定义
├── utils/                    # 工具模块
│   ├── index.ts              # 工具导出
│   ├── logging.ts            # 日志记录工具
│   ├── errors.ts             # 错误类
│   └── ...                   # 其他工具
├── tools/                    # 单个工具实现
│   ├── index.ts              # 工具注册
│   ├── exampleTool.ts        # 示例工具实现
│   └── ...                   # 其他工具
├── resources/                # 资源实现
│   ├── index.ts              # 资源注册  
│   ├── exampleResource.ts    # 示例资源实现
│   └── ...                   # 其他资源
├── prompts/                  # 提示实现
│   ├── index.ts              # 提示注册
│   ├── examplePrompt.ts      # 示例提示实现
│   └── ...                   # 其他提示
├── services/                 # 服务层
│   ├── index.ts              # 服务导出
│   ├── exampleService.ts     # 示例服务实现
│   └── ...                   # 其他服务

根据你的选择，可能会生成其他目录：

Web API（若启用）

├── web/                      # Web API 组件
│   ├── index.ts              # Web 服务器设置
│   ├── middleware/           # Express 中间件
│   │   ├── index.ts          # 中间件导出
│   │   ├── errorHandler.ts   # 错误处理中间件
│   │   └── ...               # 其他中间件
│   ├── routes/                # 路由定义
│   │   ├── index.ts          # 路由导出
│   │   ├── exampleRoute.ts    # 示例路由实现
│   │   └── ...               # 其他路由
│   └── controllers/          # 控制器
│       ├── index.ts          # 控制器导出
│       ├── exampleController.ts  # 示例控制器实现
│       └── ...               # 其他控制器

WebSocket（若启用）

├── websockets/                # WebSocket 组件
│   ├── index.ts              # WebSocket 服务器设置
│   ├── exampleWebSocket.ts    # 示例 WebSocket 实现
│   └── ...                   # 其他 WebSocket 相关文件

Prisma（若启用）

├── prisma/                    # Prisma 配置
│   ├── schema.prisma          # 数据库模式定义
│   ├── index.ts              # Prisma 初始化
│   └── ...                   # 其他 Prisma 相关文件

许可证

[此处应放置许可证文本，例如 MIT 或其他适用的许可证。]

请根据实际项目需求补充完整的许可证信息。