MCP Server Templates

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

� 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?

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:
   • 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!