⚠️ 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:

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

Version Python Versions License Discord

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?

Traditional MCP Setup	With MCP Templates
❌ Complex configuration	✅ One-command deployment
❌ Docker expertise required	✅ Zero configuration needed
❌ Manual tool discovery	✅ Automatic detection
❌ Environment setup headaches	✅ Pre-built containers

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

Template	Description	Transport	Use Case
demo	Hello world MCP server	HTTP, stdio	Testing & learning
filesystem	Secure file operations	stdio	File management
gitlab	GitLab API integration	stdio	CI/CD workflows
github	GitHub API integration	stdio	Development workflows
zendesk	Customer support tools	HTTP, stdio	Support automation

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:

   • New docs: https://data-everything.github.io/MCP-Platform/
   • New repository: https://github.com/Data-Everything/MCP-Platform

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!