MCP Server Generator

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

🎬 Video Showcase

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

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

Overview

✨ Modern Architecture

🎯 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

🌟 What Makes This Different

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

Quick Start

Installation

# One-time usage (recommended)
npx mcp-server-generator my-project

# Global installation
npm install -g mcp-server-generator
mcp-server-generator my-project

Basic Usage

# 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

Immediate Testing

# 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

Extending Existing Projects

➕ Add Components to Existing Projects

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"

🔍 List Existing Components

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

⚙️ Smart Component Generation

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

🛠️ Component Types

Type	Description	Examples
🛠️ Tool	Add functionality and actions	`calculator`, `file-manager`, `data-validator`
📋 Resource	Add data and documentation	`user-guide`, `api-docs`, `configuration`
💡 Prompt	Add intelligent templates	`code-review`, `analysis`, `summary`
⚙️ Service	Add business logic	`email-sender`, `data-processor`, `auth-manager`
🌐 Transport	Add communication layers	`websocket`, `grpc`, `mqtt`
🔧 Util	Add helper functions	`string-helpers`, `crypto-utils`, `validators`

Features

🔧 Comprehensive Tools (8 powerful tools)

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

📋 Rich Resources (9 comprehensive resources)

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

💡 Flexible Prompts (3 intelligent prompts)

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

✨ Advanced Features

🧠 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

🚀 Transport Support

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

CLI Commands

🚀 Create New Projects

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)

➕ Add Components to Existing Projects

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

📋 List Project Components

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

Generated Project Structure

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

Usage Examples

🚀 Quick Start Testing

# 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

🧪 Testing the Data Analysis Tool

# 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'

➕ Adding and Testing New Components

# 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

Development Scripts

📝 Available Scripts (for generated projects)

# 🚀 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

🎉 Enhanced Developer Experience

This generator has been thoroughly tested and improved with:

✅ Production-Ready Quality

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

🚀 Instant Productivity

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

Development

Building the CLI

# Install dependencies
npm install

# Build the CLI tool
npm run build

# Test locally
npm link
mcp-server-generator test-analysis-server

Generated Project Dependencies

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

Architecture

CLI Structure

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

Component Extension System

The CLI now includes a powerful component extension system:

🔍 Project Detection

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

🏗️ Dynamic Component Generation

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

🔧 Registry Management

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

💾 Safe Operations

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

Advanced Template System

Our template system generates production-ready MCP servers with:

🏗️ Clean Architecture

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

🎯 Unified Examples

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

🔧 Advanced MCP Features

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

🔍 Integrated Testing

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

🚀 Production Features

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

Contributing

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

Development Guidelines

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

Documentation

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

License

MIT License - see LICENSE file for details.

Acknowledgments

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

Create-MCP

MCP Server Generator

🎬 Video Showcase

📋 Table of Contents

Overview

✨ Modern Architecture

🌟 What Makes This Different

Quick Start

Installation

Basic Usage

Immediate Testing

Extending Existing Projects

➕ Add Components to Existing Projects

🔍 List Existing Components

⚙️ Smart Component Generation

🛠️ Component Types

Features

🔧 Comprehensive Tools (8 powerful tools)

📋 Rich Resources (9 comprehensive resources)

💡 Flexible Prompts (3 intelligent prompts)

✨ Advanced Features

🚀 Transport Support

CLI Commands

🚀 Create New Projects

➕ Add Components to Existing Projects

📋 List Project Components

Generated Project Structure

Usage Examples

🚀 Quick Start Testing

🧪 Testing the Data Analysis Tool

➕ Adding and Testing New Components

Development Scripts

📝 Available Scripts (for generated projects)

🎉 Enhanced Developer Experience

✅ Production-Ready Quality

🚀 Instant Productivity

Development

Building the CLI

Generated Project Dependencies

Architecture

CLI Structure

Component Extension System

🔍 Project Detection

🏗️ Dynamic Component Generation

🔧 Registry Management

💾 Safe Operations

Advanced Template System

🏗️ Clean Architecture

🎯 Unified Examples

🔧 Advanced MCP Features

🔍 Integrated Testing

🚀 Production Features

Contributing

Development Guidelines

Documentation

License

Acknowledgments

Reviews