mcp-templates 1.1.5

MCP-Server-Templates: Easy, zero-config deployment for Model Context Protocol servers

MCP Server Templates

📚 Documentation • 💬 Discord Community • 🚀 Quick Start

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 →

---

📖 Documentation

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