A modern CLI tool for generating and extending production-ready Model Context Protocol (MCP) servers. Built with clean architecture and advanced MCP features, this tool creates servers that demonstrate all MCP capabilities through one cohesive example instead of scattered demos. Now with powerful component extension capabilities!

📦 Available on npm: mcp-server-generator - 442kB of production-ready MCP server templates
📚 Complete Documentation: mcp-server-generator.com

See the MCP Server Generator in action! Watch how easy it is to create a production-ready MCP server:

Watch Demo Video

Watch the complete workflow from project generation to testing with MCP Inspector

📖 Detailed guides and tutorials: mcp-server-generator.com

• Video Showcase
• Overview
• Quick Start
• Extending Existing Projects
• Features
• CLI Commands
• Generated Project Structure
• Usage Examples
• Development Scripts
• Development
• Architecture
• Contributing
• License

📚 For comprehensive documentation, examples, and guides, visit mcp-server-generator.com

• 🎯 Unified Example: One comprehensive Data Analysis Assistant showcasing ALL MCP features
• 🏗️ Clean Architecture: Modular design with proper separation of concerns
• 🔧 Advanced MCP Features: Elicitation, sampling, multiple analysis methodologies
• 🔍 MCP Inspector Integration: Built-in testing with visual and CLI modes
• 📚 Production Ready: Comprehensive error handling, validation, and documentation
• 🚀 Educational: Learn MCP best practices through real-world implementation
• ➕ Extensible: Add new components to existing projects with intelligent automation

Unlike other MCP generators that create scattered demo examples, this tool provides:

• 🎯 One Unified Example: Data Analysis Assistant showcasing ALL MCP features
• 🏗️ Clean Architecture: Maintainable, extensible, production-ready code
• 📚 Educational Value: Learn MCP best practices through real implementation
• 🧪 Integrated Testing: MCP Inspector ready-to-use with pre-configured scripts
• 🚀 Developer Experience: Convenient scripts, help system, instant feedback
• ➕ Component Extension: Add tools, resources, prompts, services, transports, and utils to existing projects

Perfect for learning MCP development, building production servers, or as a foundation for custom implementations. Start with our comprehensive example, then extend with your own components!

📚 Complete Documentation: mcp-server-generator.com
🚀 Quick Start Guide: Installation & Setup
💡 Examples & Tutorials: Component Examples

# One-time usage (recommended) npx mcp-server-generator my-project # Global installation npm install -g mcp-server-generator mcp-server-generator my-project

# Create a comprehensive MCP server with Data Analysis Assistant npx mcp-server-generator my-analysis-server # Or specify custom options npx mcp-server-generator my-analysis-server --transport both --skip-install

# Create and enter project npx mcp-server-generator my-analysis-server cd my-analysis-server # 1️⃣ See everything at once npm run quick:test # Shows all 8 tools, 9 resources, 3 prompts # 2️⃣ Get help with all commands npm run help # Complete command reference # 3️⃣ Test with MCP Inspector (2 terminals) # Terminal 1: npm run dev:http:stateless # Terminal 2: npm run inspector:config -- --server my-analysis-server-http

Easily extend your MCP servers with new components using the powerful add command:

# Add a new tool npx mcp-server-generator add tool calculator npx mcp-server-generator add tool file-manager --description "File management tool" # Add a new resource  npx mcp-server-generator add resource user-data npx mcp-server-generator add resource api-docs --author "Your Name" # Add a new prompt npx mcp-server-generator add prompt code-review npx mcp-server-generator add prompt system-design --description "System design prompt" # Add business logic services npx mcp-server-generator add service email-sender npx mcp-server-generator add service data-processor --description "Process data" # Add custom transports npx mcp-server-generator add transport websocket npx mcp-server-generator add transport grpc --description "gRPC transport" # Add utility functions npx mcp-server-generator add util string-helpers npx mcp-server-generator add util crypto-utils --description "Cryptography utilities"

See what components are already in your project:

# Navigate to your MCP project cd my-mcp-project # List all components npx mcp-server-generator list

Each component type includes:

• 📝 Interactive Configuration: Rich prompts for component-specific settings
• 🔧 Automatic Integration: Components are automatically registered and ready to use
• 💾 Backup & Rollback: Safe modifications with automatic backup creation
• ✅ Validation: Name validation and conflict detection
• 📚 Production-Ready Code: Generated components follow MCP best practices
• 🎯 Type Safety: Full TypeScript support with proper typing

• data-analysis: Complete analysis with 5 methodologies, 6 sampling strategies, elicitation integration
• server-status: Health monitoring and performance tracking
• start-elicitation: Begin interactive elicitation sessions for guided information gathering
• continue-elicitation: Continue active elicitation sessions with responses
• get-elicitation-status: Get status and summary of elicitation sessions
• generate-sample: Generate samples using 6 different sampling strategies
• analyze-sample: Analyze sample quality and representativeness
• generate-synthetic-data: Generate synthetic data based on source patterns

• data-analysis: Comprehensive guide to data analysis approaches and techniques
• sampling-guide: Complete guide to data sampling techniques and strategies
• elicitation-workflows: Interactive elicitation workflows for guided analysis
• analysis-best-practices: Industry best practices for effective data analysis
• server-info: Comprehensive server information and capabilities
• server-config: Current server configuration and runtime settings
• api-docs: Complete API documentation for the MCP server
• sampling-strategies: Documentation of available sampling strategies
• sampling-best-practices: Guidelines for effective data sampling

• research-analysis: 8 research methodologies with flexible contexts and output formats
• interactive-exploration: Generate interactive exploration questions for topics
• guided-discovery: Create guided discovery sessions for knowledge elicitation

• 🧠 Interactive Elicitation: Guided analysis with smart question generation
• 📊 AI-Enhanced Sampling: 6 sampling strategies including AI-powered techniques
• 🏗️ Modular Architecture: Clean separation of concerns with dependency injection
• 🔍 MCP Inspector Integration: Visual and CLI testing built-in
• ➕ Component Extension: Add new tools, resources, prompts, services, transports, and utilities
• 🔧 Intelligent Integration: Automatic registry updates and import management
• 💾 Safe Modifications: Backup and rollback system for project changes
• 🎯 Smart Validation: Component name validation and conflict detection

• Stdio Transport: Standard input/output for Claude Desktop and CLI tools
• HTTP Transport: RESTful API with Server-Sent Events for web integration
• Streamable HTTP: Modern protocol 2025-03-26 with session management

npx mcp-server-generator <project-name> [options]

Options:

• <project-name>: Name of the MCP server project (required)
• -t, --transport <type>: Transport type (stdio, http, both) - default: both
• -d, --directory <path>: Directory to create the project in
• --skip-install: Skip installing dependencies
• --verbose: Enable verbose logging
• --oauth: Enable OAuth authentication for HTTP transport
• --no-dns-protection: Disable DNS rebinding protection
• --stateless: Enable stateless mode (no session persistence)

npx mcp-server-generator add <component-type> <component-name> [options]

Component Types:

• tool - Add functionality and tools to your MCP server
• resource - Add data and documentation resources
• prompt - Add intelligent prompt templates
• service - Add business logic and processing services
• transport - Add custom communication transports
• util - Add helper functions and utilities

Options:

• <component-type>: Type of component to add (required)
• <component-name>: Name of the component (required)
• -d, --description <desc>: Component description
• -a, --author <author>: Component author
• --skip-validation: Skip component name validation
• --verbose: Enable verbose logging

npx mcp-server-generator list [options]

Options:

• --verbose: Enable verbose logging

Examples:

# Create a new project npx mcp-server-generator my-server --transport both # Add components to existing project cd my-server npx mcp-server-generator add tool calculator --description "Math calculator" npx mcp-server-generator add resource user-guide --author "Team" # List all components npx mcp-server-generator list

my-analysis-server/ ├── src/ │ ├── server.ts # Simplified main entry point (106 lines) │ ├── core/ # Core server logic │ │ ├── config.ts # Configuration management │ │ ├── mcp-server.ts # Core MCP server implementation │ │ └── server-factory.ts # Server instantiation │ ├── transports/ # Transport layer │ │ ├── stdio-transport.ts # Stdio communication │ │ ├── http-transport.ts # HTTP communication │ │ └── transport-manager.ts # Transport coordination │ ├── tools/ # Modular tool implementations │ │ ├── index.ts # Tool registry │ │ ├── data-analysis-tool.ts # Comprehensive analysis tool │ │ └── server-status-tool.ts # Monitoring tool │ ├── resources/ # Resource providers │ │ ├── index.ts # Resource registry │ │ ├── data-analysis-resource.ts # Analysis documentation │ │ └── server-info-resource.ts # Server information │ ├── prompts/ # Prompt templates │ │ ├── index.ts # Prompt registry │ │ └── research-analysis-prompt.ts # Multi-methodology prompts │ ├── services/ # Business logic │ │ ├── elicitation.ts # Interactive guidance │ │ ├── sampling.ts # Data sampling │ │ └── example.ts # Example service │ └── utils/ # Utilities │ ├── logger.ts # Logging system │ └── health.ts # Health monitoring ├── mcp-inspector.config.json # MCP Inspector configuration ├── package.json # Dependencies and scripts ├── tsconfig.json # TypeScript configuration └── README.md # Comprehensive documentation 

# Test individual components npm run test:tools # List data-analysis and server-status tools npm run test:resources # Browse methodology guides and documentation  npm run test:prompts # Test research-analysis prompt # Start different modes npm run dev:stdio # For Claude Desktop integration npm run dev:http # For API/web integration npm run dev:http:oauth # With authentication # Visual inspector (UI mode) npm run inspector # CLI-based testing npm run inspector:cli

# Quick test (shows tool schema) npm run test:tools # Advanced test with actual data npx @modelcontextprotocol/inspector --cli tsx src/server.ts \ --method tools/call \ --tool-name data-analysis \ --tool-arg 'data=[{"age":25,"score":85},{"age":30,"score":92}]' \ --tool-arg analysis_type=exploratory \ --tool-arg sampling_strategy=ai-representative \ --tool-arg enable_elicitation=true # Test server status monitoring npx @modelcontextprotocol/inspector --cli tsx src/server.ts \ --method tools/call \ --tool-name server-status \ --tool-arg 'include_details=true' \ --tool-arg 'format=json'

# Add a custom tool and test it immediately npx mcp-server-generator add tool calculator --description "Math calculator" npm run build npm run test:tools # Your new tool will appear in the list # Add a resource and verify it npx mcp-server-generator add resource user-guide --description "User documentation" npm run test:resources # New resource will be listed # Add a prompt and test it npx mcp-server-generator add prompt code-review --description "Code review prompt" npm run test:prompts # New prompt will be available # Test your extended server npm run dev:stdio # Start with all components npm run inspector:cli # Test all components interactively

# 🚀 Quick Start & Testing npm run quick:test # Show ALL tools, resources & prompts at once npm run help # Show all available commands # 🔧 Development npm run dev:stdio # Start with stdio transport (for Claude Desktop) npm run dev:http # Start with HTTP transport npm run dev:http:stateless # Start HTTP in stateless mode (best for inspector) npm run dev:http:oauth # Start with OAuth enabled # 🌐 MCP Inspector Integration (2 terminals) # Terminal 1: npm run dev:http:stateless # Terminal 2: npm run inspector:config -- --server your-project-http # 📋 Individual Testing  npm run test:tools # List available tools npm run test:resources # List available resources npm run test:prompts # List available prompts # 🔍 Inspector Options npm run inspector # Launch visual inspector (UI mode) npm run inspector:cli # Command line testing npm run inspector:config # Use configuration-based testing # 🚀 Production npm run build # Build TypeScript npm run start:stdio # Production stdio npm run start:http # Production HTTP npm run start:http:stateless # Production HTTP stateless

This generator has been thoroughly tested and improved with:

• Zero TypeScript Errors: All 26+ compilation issues resolved
• Working Scripts: Every npm script tested and functional
• Clean Architecture: Proper separation of concerns with dependency injection
• Error Handling: Comprehensive validation and graceful error recovery

• One-Command Testing: npm run quick:test shows everything at once
• Built-in Help: npm run help provides complete command reference
• Smart Defaults: Optimized configurations for immediate use
• Inspector Integration: Seamless MCP Inspector setup with clear instructions

# Install dependencies npm install # Build the CLI tool npm run build # Test locally npm link mcp-server-generator test-analysis-server

Every generated project includes carefully selected dependencies:

Core MCP:

• @modelcontextprotocol/sdk: Official MCP TypeScript SDK
• @modelcontextprotocol/inspector: Visual testing tool (dev dependency)
• zod: Runtime type validation and schema definition

HTTP Transport:

• express: Web server framework
• cors: Cross-origin resource sharing

Development & Quality:

• typescript: TypeScript compiler
• tsx: TypeScript execution engine
• eslint: Code linting with TypeScript rules
• jest: Testing framework
• rimraf: Clean builds

mcp-server-generator/ ├── bin/ │ ├── create-mcp.js # CLI entry point │ └── index.js # Alternative entry ├── src/ │ ├── cli/ # CLI implementation │ │ ├── index.ts # Main CLI logic with add/list commands │ │ ├── generator.ts # Project generation │ │ ├── prompts.ts # User interaction │ │ ├── validator.ts # Input validation │ │ ├── add-component.ts # Component addition logic │ │ └── add-prompts.ts # Component configuration prompts │ ├── helpers/ # Helper utilities │ │ ├── examples.ts # Example data │ │ ├── install.ts # Dependency installation │ │ └── validate-pkg.ts # Package validation │ ├── types/ # TypeScript types (extended for components) │ ├── utils/ # Core utilities │ │ ├── file-operations.ts # File system operations │ │ ├── template-processor.ts # Template processing │ │ ├── package-manager.ts # Package management │ │ ├── project-detector.ts # Project detection & validation │ │ ├── component-templates.ts # Dynamic component generation │ │ └── registry-updater.ts # Registry file management │ └── templates/ # Template generation system │ ├── base/ # Base project files │ │ ├── package.json.template │ │ ├── README.md.template │ │ └── tsconfig.json.template │ └── src/ # Source code templates │ ├── core/ # Core server modules │ ├── tools/ # Tool implementations │ ├── resources/ # Resource providers │ ├── prompts/ # Prompt templates │ ├── services/ # Business logic │ ├── transports/ # Transport handlers │ └── utils/ # Utility modules ├── lib/ # Built JavaScript (generated) └── package.json # CLI dependencies 

The CLI now includes a powerful component extension system:

• Automatically detects valid MCP server projects
• Validates project structure and dependencies
• Checks for required files and registry structure

• Template-based component generation for each type
• Type-specific configuration and validation
• Production-ready code with proper TypeScript types

• Automatic import and export management
• Registry file updates (tools, resources, prompts)
• Component integration with existing architecture

• Backup creation before modifications
• Rollback capability on failures
• Conflict detection and prevention

Our template system generates production-ready MCP servers with:

• Modular Design: Each component has single responsibility
• Dependency Injection: Clean separation of concerns
• Registry Pattern: Easy extension and testing
• Factory Pattern: Centralized server creation

• One Comprehensive Example: Data Analysis Assistant showcasing ALL features
• No Scattered Demos: Everything integrated and cohesive
• Real-World Applicable: Practical use case developers can adapt
• Educational Value: Learn MCP best practices through implementation

• 5 Analysis Methodologies: exploratory, descriptive, diagnostic, predictive, prescriptive
• 6 Sampling Strategies: Including AI-enhanced techniques
• Interactive Elicitation: Smart question generation and guided workflows
• Multi-Methodology Prompts: 8 research approaches with flexible contexts

• MCP Inspector: Visual and CLI testing built-in
• Comprehensive Scripts: Ready-to-use testing commands
• Configuration Files: Pre-configured inspector settings
• Development Workflow: Immediate testing capability

• Multiple Transports: Stdio, HTTP, Streamable HTTP
• Session Management: Stateful and stateless modes
• Security: OAuth, CORS, DNS protection
• Monitoring: Health checks, status reporting, comprehensive logging
• Extensibility: Add new components without breaking existing functionality
• Type Safety: Full TypeScript support for all generated components

1. Fork the repository
2. Create your feature branch: git checkout -b feature/amazing-feature
3. Make your changes and add tests
4. Build and test: npm run build && npm test
5. Commit your changes: git commit -m 'Add amazing feature'
6. Push to the branch: git push origin feature/amazing-feature
7. Open a Pull Request

• Follow the unified architecture approach (no scattered examples)
• Maintain clean separation of concerns
• Add comprehensive tests for new features
• Update documentation for API changes
• Use conventional commit messages

• Main Documentation: mcp-server-generator.com
• API Reference: mcp-server-generator.com/docs/api/overview
• Contributing Guide: GitHub Contributing Guidelines

MIT License - see LICENSE file for details.

This project is inspired by and builds upon:

• Model Context Protocol - The protocol specification and community
• MCP TypeScript SDK - The official TypeScript SDK
• MCP Inspector - Visual testing tool for MCP servers
• create-next-app - CLI design patterns
• Neon's MCP Server - MCP server implementation patterns

MCP Server Generator - Generate and extend production-ready Model Context Protocol servers with comprehensive Data Analysis Assistant, component addition capabilities, and integrated testing.

Package Information:

• npm Package: mcp-server-generator
• GitHub: LinuxDevil/Create-MCP
• Size: 442 kB (155+ files)
• Commands: mcp-server-generator or create-mcp

New Features:

• ➕ Component Addition: mcp-server-generator add <type> <name>
• 📋 Component Listing: mcp-server-generator list
• 🔧 6 Component Types: tools, resources, prompts, services, transports, utils
• 🎯 Smart Integration: Automatic registry updates and type-safe generation

📚 Learn More:

• Complete Documentation: mcp-server-generator.com
• API Reference: mcp-server-generator.com/docs/api/overview
• Component Guide: mcp-server-generator.com/docs/components/overview
• CLI Reference: mcp-server-generator.com/docs/cli-commands