/mcp-server-templates

A flexible platform that provides Docker & Kubernetes backends, a lightweight CLI (mcpt), and client utilities for seamless MCP integration. Spin up servers from templates, route requests through a single endpoint with load balancing, and support both deployed (HTTP) and local (stdio) transports — all with sensible defaults and YAML-based configs.

Primary LanguagePythonOtherNOASSERTION

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

# 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

Migrate to MCP Platform💬 Discord Community� Legacy Docs

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:

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)


🤝 Community


📝 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!