🚀 This Project Has Moved!

> ## ⚠️ **IMPORTANT: This repository has been renamed and moved to MCP Platform**

>

> What changed:

> - New Repository: `Data-Everything/MCP-Platform`

> - New Package: `pip install mcp-platform` (replaces `mcp-templates`)

> - New CLI: `mcpp` command (replaces `mcpt`)

> - Enhanced Features: Improved architecture and expanded capabilities

>

> Migration is easy:

> ```bash

> # Uninstall old package

> pip uninstall mcp-templates

>

> # Install new package

> pip install mcp-platform

>

> # Use new command (all your configs work the same!)

> mcpp deploy demo # instead of mcpt deploy demo

> ```

>

> **📚 Complete Migration Guide | 🆕 New Documentation**

MCP Server Templates (Legacy)

> **⚠️ This version is in maintenance mode. Please migrate to MCP Platform for latest features and updates.**

> Deploy Model Context Protocol (MCP) servers in seconds, not hours.

Zero-configuration deployment of production-ready MCP servers with Docker containers, comprehensive CLI tools, and intelligent caching. Focus on AI integration, not infrastructure setup.

🚀 Quick Start

# Install MCP Templates
pip install mcp-templates

# List available templates
mcpt list

# Deploy instantly
mcpt deploy demo

# View deployment
mcpt logs demo

That's it! Your MCP server is running at `http://localhost:8080`

⚡ Why MCP Templates?

Perfect for: AI developers, data scientists, DevOps teams building with MCP.

🌟 Key Features

🖱️ One-Click Deployment

Deploy MCP servers instantly with pre-built templates—no Docker knowledge required.

🔍 Smart Tool Discovery

Automatically finds and showcases every tool your server offers.

🧠 Intelligent Caching

6-hour template caching with automatic invalidation for lightning-fast operations.

💻 Powerful CLI

Comprehensive command-line interface for deployment, management, and tool execution.

🛠️ Flexible Configuration

Configure via JSON, YAML, environment variables, CLI options, or override parameters.

📦 Growing Template Library

Ready-to-use templates for common use cases: filesystem, databases, APIs, and more.

📚 Installation

PyPI (Recommended)

pip install mcp-templates

Docker

docker run --privileged -it dataeverything/mcp-server-templates:latest deploy demo

From Source

git clone https://github.com/DataEverything/mcp-server-templates.git
cd mcp-server-templates
pip install -r requirements.txt

🎯 Common Use Cases

Deploy with Custom Configuration

# Basic deployment
mcpt deploy filesystem --config allowed_dirs="/path/to/data"

# Advanced overrides
mcpt deploy demo --override metadata__version=2.0 --transport http

Manage Deployments

# List all deployments
mcpt list --deployed

# Stop a deployment
mcpt stop demo

# View logs
mcpt logs demo --follow

Template Development

# Create new template
mcpt create my-template

# Test locally
mcpt deploy my-template --backend mock

🏗️ Architecture

┌─────────────┐    ┌───────────────────┐    ┌─────────────────────┐
│  CLI Tool   │───▶│ DeploymentManager │───▶│ Backend (Docker)    │
│  (mcpt)     │    │                   │    │                     │
└─────────────┘    └───────────────────┘    └─────────────────────┘
       │                      │                        │
       ▼                      ▼                        ▼
┌─────────────┐    ┌───────────────────┐    ┌─────────────────────┐
│ Template    │    │ CacheManager      │    │ Container Instance  │
│ Discovery   │    │ (6hr TTL)         │    │                     │
└─────────────┘    └───────────────────┘    └─────────────────────┘

Configuration Flow: Template Defaults → Config File → CLI Options → Environment Variables

📦 Available Templates

View all templates →

🛠️ Configuration Examples

Basic Configuration

mcpt deploy filesystem --config allowed_dirs="/home/user/data"

Advanced Configuration

mcpt deploy gitlab \
  --config gitlab_token="$GITLAB_TOKEN" \
  --config read_only_mode=true \
  --override metadata__version=1.2.0 \
  --transport stdio

Configuration File

{
  "allowed_dirs": "/home/user/projects",
  "log_level": "DEBUG",
  "security": {
    "read_only": false,
    "max_file_size": "100MB"
  }
}

mcpt deploy filesystem --config-file myconfig.json

🔧 Template Development

Creating Templates

1. Use the generator:

mcpt create my-template

2. Define template.json:

{
     "name": "My Template",
     "description": "Custom MCP server",
     "docker_image": "my-org/my-mcp-server",
     "transport": {
       "default": "stdio",
       "supported": ["stdio", "http"]
     },
     "config_schema": {
       "type": "object",
       "properties": {
         "api_key": {
           "type": "string",
           "env_mapping": "API_KEY",
           "sensitive": true
         }
       }
     }
   }

3. Test and deploy:

mcpt deploy my-template --backend mock

Full template development guide →

� Migration to MCP Platform

This repository has evolved into MCP Platform with enhanced features and better architecture.

Why We Moved

1. Better Naming: "MCP Platform" better reflects the comprehensive nature of the project

2. Enhanced Architecture: Improved codebase structure and performance

3. Expanded Features: More deployment options, better tooling, enhanced templates

4. Future Growth: Better positioned for upcoming MCP ecosystem developments

What Stays the Same

• ✅ All your existing configurations work unchanged
• ✅ Same Docker images and templates
• ✅ Same deployment workflows
• ✅ Full backward compatibility during transition

Migration Steps

1. Install new package:

pip uninstall mcp-templates
   pip install mcp-platform

2. Update commands:

# Old command
   mcpt deploy demo

   # New command (everything else identical)
   mcpp deploy demo

3. Update documentation bookmarks:

Support Timeline

• Current (Legacy) Package: Security updates only through 2025
• New Platform: Active development, new features, full support
• Migration Support: Available through Discord and GitHub issues

**🚀 Start your migration now →**

�📖 Documentation (Legacy)

• **Getting Started** - Installation and first deployment
• **CLI Reference** - Complete command documentation
• **Template Guide** - Creating and configuring templates
• **User Guide** - Advanced usage and best practices

🤝 Community

• **Discord Server** - Get help and discuss features
• **GitHub Issues** - Report bugs and request features
• **Discussions** - Share templates and use cases

📝 License

This project is licensed under the Elastic License 2.0.

🙏 Acknowledgments

Built with ❤️ for the MCP community. Thanks to all contributors and template creators!