🚀 Meta-MCP Framework

A robust meta-framework for dynamically generating and deploying Model Context Protocol (MCP) servers

🎯 What is This?

Meta-MCP Framework is a revolutionary code generation system that enables you to create MCP servers by simply filling out a form. It's a meta-server that generates other MCP servers automatically.

Key Features

✨ Dynamic Server Generation - Generate complete MCP servers from specifications 🎨 Template-Based Architecture - Extensible template system for different server types 📝 Form-Driven Configuration - JSON Schema-based forms for easy server specification 🔧 Multiple Server Types - Support for API wrappers, database connectors, file systems, and more ⚡ Production Ready - Generated servers follow best practices and include full TypeScript typing 🔒 Type-Safe - Full Zod validation for all configurations and schemas 🚀 Auto-Deployment - Automated build and deployment of generated servers

🏗️ Architecture

The framework consists of 3 main layers:

┌─────────────────────────────────────────────────────────┐
│  Layer 1: MCP Server (Meta-Server)                     │
│  ├─ Tools for server generation                        │
│  ├─ Configuration management                           │
│  └─ Validation and orchestration                       │
├─────────────────────────────────────────────────────────┤
│  Layer 2: Generator Engine                             │
│  ├─ Template rendering (Handlebars)                    │
│  ├─ Code generation pipeline                           │
│  ├─ Schema to Zod conversion                           │
│  └─ File system operations                             │
├─────────────────────────────────────────────────────────┤
│  Layer 3: Templates & Schemas                          │
│  ├─ Server templates (various types)                   │
│  ├─ Tool/Resource/Prompt templates                     │
│  ├─ JSON Schemas for forms                             │
│  └─ Validation schemas                                 │
└─────────────────────────────────────────────────────────┘

🚀 Quick Start

Installation

npm install
npm run build

Running the Meta-Server

# Start the meta-MCP server
npm run dev

# Or use the CLI
meta-mcp-server

Using with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "meta-mcp": {
      "command": "node",
      "args": ["/path/to/meta-mcp-framework/dist/server.js"]
    }
  }
}

📖 Usage

Once the meta-server is running in Claude Desktop, you can use it to generate new MCP servers:

1. List Available Templates

   "Show me what types of MCP servers I can generate"
   

2. Generate a Server

   "Create an MCP server for interacting with a REST API"
   

3. Deploy Generated Server

   "Deploy the server I just generated"
   

🎨 Supported Server Types

Current Templates

• 🌐 API Wrapper - Generate MCP servers from OpenAPI specifications
• 💾 Database Connector - Connect to PostgreSQL, MySQL, MongoDB, etc.
• 📁 File System - Secure file operations with configurable access
• 🔧 Custom Tools - Create servers with custom tools and resources
• 📊 Data Transformer - ETL and data processing servers
• 🤖 AI Integration - Servers that connect to AI services

Coming Soon

• Git repository management
• Cloud service integrations (AWS, GCP, Azure)
• Message queue connectors (RabbitMQ, Kafka)
• Authentication servers
• And more...

🛠️ Project Structure

meta-mcp-framework/
├── src/
│   ├── server.ts                 # Main MCP server
│   ├── index.ts                  # CLI entry point
│   ├── core/
│   │   ├── generator.ts          # Code generation engine
│   │   ├── template-engine.ts    # Handlebars template rendering
│   │   ├── validator.ts          # Schema validation
│   │   └── deployer.ts           # Deployment management
│   ├── templates/
│   │   ├── base/                 # Base server templates
│   │   ├── api-wrapper/          # API wrapper templates
│   │   ├── database/             # Database templates
│   │   └── custom/               # Custom server templates
│   ├── schemas/
│   │   ├── server-config.ts      # Server configuration schemas
│   │   ├── tool-schema.ts        # Tool definition schemas
│   │   └── forms/                # JSON Schema forms
│   ├── tools/
│   │   ├── generate-server.ts    # Server generation tool
│   │   ├── list-templates.ts     # Template listing
│   │   └── deploy-server.ts      # Deployment tool
│   └── utils/
│       ├── file-ops.ts           # File operations
│       ├── logger.ts             # Logging utilities
│       └── helpers.ts            # Helper functions
├── templates/                     # Handlebars templates
├── generated-servers/            # Output directory
├── docs/                         # Documentation
└── examples/                     # Example configurations

🔧 Development

Build

npm run build

Watch Mode

npm run watch

Testing

npm test

Inspect with MCP Inspector

npx @modelcontextprotocol/inspector node dist/server.js

📚 Documentation

• Architecture Guide
• Template Development
• API Reference
• Configuration Guide
• Deployment Guide

🤝 Contributing

Contributions are welcome! Please see CONTRIBUTING.md for details.

📝 License

MIT License - see LICENSE for details.

🙏 Acknowledgments

Built with:

• Model Context Protocol by Anthropic
• TypeScript SDK
• Zod for validation
• Handlebars for templating

🔗 Links

• MCP Specification
• MCP Documentation
• GitHub Repository

Made with ❤️ for the MCP community