create-mcp-server
A CLI tool to scaffold a Model Context Protocol (MCP) server with integrated web capabilities.
This package creates a fully structured MCP server project following the architecture documented in the MCP Advanced Node specification, providing a robust foundation for MCP server development.
Features
- Generates a complete MCP server project structure
- Configurable options for web API, WebSocket, and database integration
- TypeScript-based with modern ES modules
- Includes Prisma ORM integration (optional)
- Express-based web API (optional)
- WebSocket server integration (optional)
- Example implementations for tools, resources, and prompts
- Full error handling and logging infrastructure
- Configuration system with environment variable support
Installation
npm install -g create-advanced-mcp-server
Usage
# Create a new project with 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
# Show 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
│ └── ... # Additional utilities
├── tools/ # Individual tool implementations
│ ├── index.ts # Tool registration
│ ├── exampleTool.ts # Example tool implementation
│ └── ... # Additional tools
├── resources/ # Resource implementations
│ ├── index.ts # Resource registration
│ ├── exampleResource.ts # Example resource implementation
│ └── ... # Additional resources
├── prompts/ # Prompt implementations
│ ├── index.ts # Prompt registration
│ ├── examplePrompt.ts # Example prompt implementation
│ └── ... # Additional prompts
├── services/ # Service layer
│ ├── index.ts # Service exports
│ ├── exampleService.ts # Example service implementation
│ └── ... # Additional services
Depending on your selections, additional directories may be included:
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
│ │ └── ... # Additional middleware
│ ├── routes/ # API routes
│ │ ├── index.ts # Route registration
│ │ ├── exampleRoutes.ts # Example route definitions
│ │ └── ... # Additional routes
│ └── controllers/ # API controllers
│ ├── index.ts # Controller exports
│ ├── exampleController.ts # Example controller logic
│ └── ... # Additional controllers
WebSocket (if enabled)
├── websocket/ # WebSocket components
│ ├── index.ts # WebSocket server setup
│ ├── events/ # Event definitions
│ │ ├── index.ts # Event exports
│ │ ├── exampleEvents.ts # Example event handlers
│ │ └── ... # Additional events
│ └── ... # Additional WebSocket components
Prisma (if enabled)
├── data/ # Data access layer
│ ├── index.ts # Data layer exports
│ ├── client.ts # Prisma client initialization
│ ├── database.ts # Database management (migrations)
│ ├── repositories/ # Repository implementations
│ │ ├── index.ts # Repository exports
│ │ ├── baseRepository.ts # Base repository pattern
│ │ └── ... # Additional repositories
│ └── ... # Additional data components
├── prisma/ # Prisma configuration
│ ├── schema.prisma # Database schema definition
License
MIT
