Create Advanced MCP Server

🚀 create-advanced-mcp-server

create-advanced-mcp-server 是一個 CLI 工具，用於快速搭建帶有 Web 功能的 Model Context Protocol（MCP）服務器。它能提供完整的項目結構，為 MCP 服務器開發奠定堅實基礎。

🚀 快速開始

本工具可幫助你快速創建一個符合 MCP 高級節點規範的服務器項目。以下是使用示例：

# 通過交互式提示創建新項目
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 服務器項目結構，符合 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 --skip-install --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 或其他適用的許可證。]

請根據實際項目需求補充完整的許可證信息。