11# MCP Server Generator
22
3- A modern CLI tool for generating production-ready Model Context Protocol (MCP) servers with comprehensive ** Data Analysis Assistant ** capabilities . 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.
3+ A modern CLI tool for generating production-ready Model Context Protocol (MCP). 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.
44
55[ ![ npm version] ( https://badge.fury.io/js/mcp-server-generator.svg )] ( https://www.npmjs.com/package/mcp-server-generator )
66[ ![ Downloads] ( https://img.shields.io/npm/dm/mcp-server-generator.svg )] ( https://www.npmjs.com/package/mcp-server-generator )
77[ ![ License: MIT] ( https://img.shields.io/badge/License-MIT-yellow.svg )] ( https://opensource.org/licenses/MIT )
88
99> ** 📦 Available on npm** : [ ` mcp-server-generator ` ] ( https://www.npmjs.com/package/mcp-server-generator ) - 442kB of production-ready MCP server templates
1010
11- ## ✨ ** Modern Architecture**
11+ ## 🎬 Video Showcase
12+
13+ See the MCP Server Generator in action! Watch how easy it is to create a production-ready MCP server:
14+
15+ [ Watch Demo Video] ( ./generate-mcp.mp4 )
16+
17+ Watch the complete workflow from project generation to testing with MCP Inspector
18+
19+ ## 📋 Table of Contents
20+
21+ - [ Video Showcase] ( #-video-showcase )
22+ - [ Overview] ( #overview )
23+ - [ Quick Start] ( #quick-start )
24+ - [ Features] ( #features )
25+ - [ CLI Options] ( #cli-options )
26+ - [ Generated Project Structure] ( #generated-project-structure )
27+ - [ Usage Examples] ( #usage-examples )
28+ - [ Development Scripts] ( #development-scripts )
29+ - [ Development] ( #development )
30+ - [ Architecture] ( #architecture )
31+ - [ Contributing] ( #contributing )
32+ - [ License] ( #license )
33+
34+ ## Overview
35+
36+ ### ✨ ** Modern Architecture**
1237
1338- 🎯 ** Unified Example** : One comprehensive Data Analysis Assistant showcasing ALL MCP features
1439- 🏗️ ** Clean Architecture** : Modular design with proper separation of concerns
@@ -17,39 +42,63 @@ A modern CLI tool for generating production-ready Model Context Protocol (MCP) s
1742- 📚 ** Production Ready** : Comprehensive error handling, validation, and documentation
1843- 🚀 ** Educational** : Learn MCP best practices through real-world implementation
1944
20- ## Usage
45+ ### 🌟 ** What Makes This Different **
2146
22- ``` bash
23- # Create a comprehensive MCP server with Data Analysis Assistant
24- npx mcp-server-generator my-analysis-server
47+ Unlike other MCP generators that create scattered demo examples, this tool provides:
2548
26- # Alternative command (backwards compatibility)
27- npx mcp-server-generator my-analysis-server
49+ - 🎯 ** One Unified Example** : Data Analysis Assistant showcasing ALL MCP features
50+ - 🏗️ ** Clean Architecture** : Maintainable, extensible, production-ready code
51+ - 📚 ** Educational Value** : Learn MCP best practices through real implementation
52+ - 🧪 ** Integrated Testing** : MCP Inspector ready-to-use with pre-configured scripts
53+ - 🚀 ** Developer Experience** : Convenient scripts, help system, instant feedback
2854
29- # Or specify custom options
30- npx mcp-server-generator my-analysis-server --transport both --skip-install
31- ```
55+ Perfect for learning MCP development, building production servers, or as a foundation for custom implementations.
56+
57+ ## Quick Start
3258
33- ## 📦 Quick Installation
59+ ### Installation
3460
3561``` bash
3662# One-time usage (recommended)
3763npx mcp-server-generator my-project
3864
3965# Global installation
4066npm install -g mcp-server-generator
67+ mcp-server-generator my-project
4168```
4269
43- ## CLI Options
70+ ### Basic Usage
4471
45- - ` <project-name> ` : Name of the MCP server project (required)
46- - ` -t, --transport <type> ` : Transport type (` stdio ` , ` http ` , ` both ` ) - default: ` both `
47- - ` -d, --directory <path> ` : Directory to create the project in
48- - ` --skip-install ` : Skip installing dependencies
72+ ``` bash
73+ # Create a comprehensive MCP server with Data Analysis Assistant
74+ npx mcp-server-generator my-analysis-server
75+
76+ # Or specify custom options
77+ npx mcp-server-generator my-analysis-server --transport both --skip-install
78+ ```
79+
80+ ### Immediate Testing
81+
82+ ``` bash
83+ # Create and enter project
84+ npx mcp-server-generator my-analysis-server
85+ cd my-analysis-server
86+
87+ # 1️⃣ See everything at once
88+ npm run quick:test # Shows all 8 tools, 9 resources, 3 prompts
89+
90+ # 2️⃣ Get help with all commands
91+ npm run help # Complete command reference
4992
50- ## 🚀 ** What You Get**
93+ # 3️⃣ Test with MCP Inspector (2 terminals)
94+ # Terminal 1:
95+ npm run dev:http:stateless
96+
97+ # Terminal 2:
98+ npm run inspector:config -- --server my-analysis-server-http
99+ ```
51100
52- Every generated project includes a ** comprehensive Data Analysis Assistant ** that demonstrates:
101+ ## Features
53102
54103### 🔧 ** Comprehensive Tools** (8 powerful tools)
55104
@@ -87,6 +136,19 @@ Every generated project includes a **comprehensive Data Analysis Assistant** tha
87136- 🏗️ ** Modular Architecture** : Clean separation of concerns with dependency injection
88137- 🔍 ** MCP Inspector Integration** : Visual and CLI testing built-in
89138
139+ ### 🚀 ** Transport Support**
140+
141+ - ** Stdio Transport** : Standard input/output for Claude Desktop and CLI tools
142+ - ** HTTP Transport** : RESTful API with Server-Sent Events for web integration
143+ - ** Streamable HTTP** : Modern protocol 2025-03-26 with session management
144+
145+ ## CLI Options
146+
147+ - ` <project-name> ` : Name of the MCP server project (required)
148+ - ` -t, --transport <type> ` : Transport type (` stdio ` , ` http ` , ` both ` ) - default: ` both `
149+ - ` -d, --directory <path> ` : Directory to create the project in
150+ - ` --skip-install ` : Skip installing dependencies
151+
90152## Generated Project Structure
91153
92154``` text
@@ -125,72 +187,9 @@ my-analysis-server/
125187└── README.md # Comprehensive documentation
126188```
127189
128- ### 🚀 ** Transport Support**
129-
130- - ** Stdio Transport** : Standard input/output for Claude Desktop and CLI tools
131- - ** HTTP Transport** : RESTful API with Server-Sent Events for web integration
132- - ** Streamable HTTP** : Modern protocol 2025-03-26 with session management
190+ ## Usage Examples
133191
134- ### 📝 ** Development Scripts**
135-
136- ``` bash
137- # 🚀 Quick Start & Testing
138- npm run quick:test # Show ALL tools, resources & prompts at once
139- npm run help # Show all available commands
140-
141- # 🔧 Development
142- npm run dev:stdio # Start with stdio transport (for Claude Desktop)
143- npm run dev:http # Start with HTTP transport
144- npm run dev:http:stateless # Start HTTP in stateless mode (best for inspector)
145- npm run dev:http:oauth # Start with OAuth enabled
146-
147- # 🌐 MCP Inspector Integration (2 terminals)
148- # Terminal 1: npm run dev:http:stateless
149- # Terminal 2: npm run inspector:config -- --server your-project-http
150-
151- # 📋 Individual Testing
152- npm run test:tools # List available tools
153- npm run test:resources # List available resources
154- npm run test:prompts # List available prompts
155-
156- # 🔍 Inspector Options
157- npm run inspector # Launch visual inspector (UI mode)
158- npm run inspector:cli # Command line testing
159- npm run inspector:config # Use configuration-based testing
160-
161- # 🚀 Production
162- npm run build # Build TypeScript
163- npm run start:stdio # Production stdio
164- npm run start:http # Production HTTP
165- npm run start:http:stateless # Production HTTP stateless
166- ```
167-
168- ## 🎯 ** Example Usage**
169-
170- After creating a project, you get a comprehensive Data Analysis Assistant:
171-
172- ### 🚀 ** Quick Start (Recommended)**
173-
174- ``` bash
175- # Create and enter project
176- npx mcp-server-generator my-analysis-server
177- cd my-analysis-server
178-
179- # 1️⃣ See everything at once
180- npm run quick:test # Shows all 8 tools, 9 resources, 3 prompts
181-
182- # 2️⃣ Get help with all commands
183- npm run help # Complete command reference
184-
185- # 3️⃣ Test with MCP Inspector (2 terminals)
186- # Terminal 1:
187- npm run dev:http:stateless
188-
189- # Terminal 2:
190- npm run inspector:config -- --server my-analysis-server-http
191- ```
192-
193- ### 🔍 ** Advanced Testing**
192+ ### 🚀 ** Quick Start Testing**
194193
195194``` bash
196195# Test individual components
@@ -233,40 +232,60 @@ npx @modelcontextprotocol/inspector --cli tsx src/server.ts \
233232 --tool-arg ' format=json'
234233```
235234
236- ## 🎉 ** Enhanced Developer Experience**
235+ ## Development Scripts
236+
237+ ### 📝 ** Available Scripts** (for generated projects)
238+
239+ ``` bash
240+ # 🚀 Quick Start & Testing
241+ npm run quick:test # Show ALL tools, resources & prompts at once
242+ npm run help # Show all available commands
243+
244+ # 🔧 Development
245+ npm run dev:stdio # Start with stdio transport (for Claude Desktop)
246+ npm run dev:http # Start with HTTP transport
247+ npm run dev:http:stateless # Start HTTP in stateless mode (best for inspector)
248+ npm run dev:http:oauth # Start with OAuth enabled
249+
250+ # 🌐 MCP Inspector Integration (2 terminals)
251+ # Terminal 1: npm run dev:http:stateless
252+ # Terminal 2: npm run inspector:config -- --server your-project-http
253+
254+ # 📋 Individual Testing
255+ npm run test:tools # List available tools
256+ npm run test:resources # List available resources
257+ npm run test:prompts # List available prompts
258+
259+ # 🔍 Inspector Options
260+ npm run inspector # Launch visual inspector (UI mode)
261+ npm run inspector:cli # Command line testing
262+ npm run inspector:config # Use configuration-based testing
263+
264+ # 🚀 Production
265+ npm run build # Build TypeScript
266+ npm run start:stdio # Production stdio
267+ npm run start:http # Production HTTP
268+ npm run start:http:stateless # Production HTTP stateless
269+ ```
270+
271+ ### 🎉 ** Enhanced Developer Experience**
237272
238273This generator has been thoroughly tested and improved with:
239274
240- ### ✅ ** Production-Ready Quality**
275+ #### ✅ ** Production-Ready Quality**
276+
241277- ** Zero TypeScript Errors** : All 26+ compilation issues resolved
242278- ** Working Scripts** : Every npm script tested and functional
243279- ** Clean Architecture** : Proper separation of concerns with dependency injection
244280- ** Error Handling** : Comprehensive validation and graceful error recovery
245281
246- ### 🚀 ** Instant Productivity**
282+ #### 🚀 ** Instant Productivity**
283+
247284- ** One-Command Testing** : ` npm run quick:test ` shows everything at once
248285- ** Built-in Help** : ` npm run help ` provides complete command reference
249286- ** Smart Defaults** : Optimized configurations for immediate use
250287- ** Inspector Integration** : Seamless MCP Inspector setup with clear instructions
251288
252- ### 🔧 ** Advanced Features**
253- - ** 8 Comprehensive Tools** : Including interactive elicitation and AI sampling
254- - ** 9 Rich Resources** : Complete documentation and methodology guides
255- - ** 3 Flexible Prompts** : Multi-methodology research analysis
256- - ** Multiple Transports** : Stdio, HTTP, and Streamable HTTP support
257-
258- ### 🌟 ** What Makes This Different**
259-
260- Unlike other MCP generators that create scattered demo examples, this tool provides:
261-
262- - 🎯 ** One Unified Example** : Data Analysis Assistant showcasing ALL MCP features
263- - 🏗️ ** Clean Architecture** : Maintainable, extensible, production-ready code
264- - 📚 ** Educational Value** : Learn MCP best practices through real implementation
265- - 🧪 ** Integrated Testing** : MCP Inspector ready-to-use with pre-configured scripts
266- - 🚀 ** Developer Experience** : Convenient scripts, help system, instant feedback
267-
268- Perfect for learning MCP development, building production servers, or as a foundation for custom implementations.
269-
270289## Development
271290
272291### Building the CLI
@@ -386,19 +405,6 @@ Our template system generates **production-ready MCP servers** with:
386405- ** Security** : OAuth, CORS, DNS protection
387406- ** Monitoring** : Health checks, status reporting, comprehensive logging
388407
389- ## ✨ ** Why This Approach?**
390-
391- Traditional MCP generators create confusing scattered examples (calculator, echo, etc.). Our approach provides:
392-
393- - 🎯 ** One comprehensive example** instead of confusing scattered demos
394- - 🏗️ ** Clean separation of concerns** for maintainable code
395- - 📚 ** Educational value** showing how all MCP features work together
396- - 🔧 ** Real-world applicability** with practical data analysis use case
397- - 🧪 ** Built-in testing** with MCP Inspector integration
398- - 📈 ** Scalable foundation** for building complex MCP servers
399-
400- Perfect for learning MCP development, building production servers, or as a foundation for custom implementations.
401-
402408## Contributing
403409
4044101 . Fork the repository
@@ -435,21 +441,9 @@ This project is inspired by and builds upon:
435441
436442** MCP Server Generator** - Generate production-ready Model Context Protocol servers with comprehensive Data Analysis Assistant and integrated testing.
437443
438- ## 📦 Installation & Usage
439-
440- ### Global Installation
441- ``` bash
442- npm install -g mcp-server-generator
443- mcp-server-generator my-project
444- ```
445-
446- ### One-time Usage (Recommended)
447- ``` bash
448- npx mcp-server-generator my-project
449- ```
444+ ** Package Information:**
450445
451- ### Package Information
452446- ** npm Package** : [ mcp-server-generator] ( https://www.npmjs.com/package/mcp-server-generator )
453447- ** GitHub** : [ LinuxDevil/Create-MCP] ( https://github.com/LinuxDevil/Create-MCP )
454448- ** Size** : 442 kB (155 files)
455- - ** Commands** : ` mcp-server-generator ` or ` create-mcp `
449+ - ** Commands** : ` mcp-server-generator ` or ` create-mcp `
0 commit comments