Create Advanced MCP Server

🚀 create-advanced-mcp-server

A CLI tool for setting up a Model Context Protocol (MCP) server with web capabilities, providing a complete project structure.

This package creates a full-fledged MCP server project based on the architecture documented in the MCP Advanced Node Specification, offering a robust foundation for MCP server development.

🚀 Quick Start

This CLI tool simplifies the process of setting up an MCP server with web functionality. It provides a complete project structure that adheres to the MCP Advanced Node Specification.

✨ Features

• Generate a complete MCP server project structure.
• Configurable options supporting Web API, WebSocket, and database integration.
• Built on TypeScript, utilizing modern ES modules.
• Optional Prisma ORM integration.
• Optional Express-based Web API.
• Optional WebSocket server integration.
• Example implementations for tools, resources, and prompts.
• Comprehensive error handling and logging infrastructure.
• Configuration system supporting environment variable configuration.

📦 Installation

npm install -g create-advanced-mcp-server

💻 Usage Examples

Basic Usage

# Create a new project via interactive prompts
npx create-advanced-mcp-server my-mcp-server

# Create a new project with default options
npx create-advanced-mcp-server my-mcp-server --yes

# Skip dependency installation
npx create-advanced-mcp-server my-mcp-server --skip-install

# Display verbose output
npx create-advanced-mcp-server my-mcp-server --verbose

Generated Project Structure

The generated project follows the structure outlined in the MCP Advanced Node Specification:

src/
├── index.ts                  # Entry point
├── initialize.ts             # Initialization logic
├── config.ts                 # Configuration management
├── types.ts                  # Type definitions
├── utils/                    # Utility modules
│   ├── index.ts              # Utility exports
│   ├── logging.ts            # Logging utilities
│   ├── errors.ts             # Error classes
│   └── ...                   # Other utilities
├── tools/                    # Individual tool implementations
│   ├── index.ts              # Tool registration
│   ├── exampleTool.ts        # Example tool implementation
│   └── ...                   # Other tools
├── resources/                # Resource implementations
│   ├── index.ts              # Resource registration  
│   ├── exampleResource.ts    # Example resource implementation
│   └── ...                   # Other resources
├── prompts/                  # Prompt implementations
│   ├── index.ts              # Prompt registration
│   ├── examplePrompt.ts      # Example prompt implementation
│   └── ...                   # Other prompts
├── services/                 # Service layer
│   ├── index.ts              # Service exports
│   ├── exampleService.ts     # Example service implementation
│   └── ...                   # Other services

Depending on your selections, additional directories may be generated:

Web API (if enabled)

├── web/                      # Web API components
│   ├── index.ts              # Web server setup
│   ├── middleware/           # Express middleware
│   │   ├── index.ts          # Middleware exports
│   │   ├── errorHandler.ts   # Error handling middleware
│   │   └── ...               # Other middleware
│   ├── routes/                # Route definitions
│   │   ├── index.ts          # Route exports
│   │   ├── exampleRoute.ts    # Example route implementation
│   │   └── ...               # Other routes
│   └── controllers/          # Controllers
│       ├── index.ts          # Controller exports
│       ├── exampleController.ts  # Example controller implementation
│       └── ...               # Other controllers

WebSocket (if enabled)

├── websockets/                # WebSocket components
│   ├── index.ts              # WebSocket server setup
│   ├── exampleWebSocket.ts    # Example WebSocket implementation
│   └── ...                   # Other WebSocket-related files

Prisma (if enabled)

├── prisma/                    # Prisma configuration
│   ├── schema.prisma          # Database schema definition
│   ├── index.ts              # Prisma initialization
│   └── ...                   # Other Prisma-related files

📄 License

[License text should be placed here, e.g., MIT or other applicable licenses.]

Please supplement the complete license information according to the actual project requirements.