antpavlenkohmcorp/mcp-dockerized repository overview

⁠🐳 MCP Dockerized

Containerized Model Context Protocol (MCP) server with extensible tools and secure API key authentication.

⁠🚀 Quick Start

⁠Basic Usage

# Run with default settings
docker run -d -p 666:666 antpavlenkohmcorp/mcp-dockerized:latest

# Check health
curl http://localhost:666/health

⁠Production Setup

# Run with persistent data and custom config
docker run -d \
  --name mcp-server \
  -p 666:666 \
  -e MCPD_LOG_LEVEL=INFO \
  -e MCPD_API_KEY_LENGTH=32 \
  -v mcp_data:/app/data \
  --restart unless-stopped \
  antpavlenkohmcorp/mcp-dockerized:latest

⁠Docker Compose

version: '3.8'
services:
  mcp-server:
    image: antpavlenkohmcorp/mcp-dockerized:latest
    ports:
      - "666:666"
    environment:
      - MCPD_PORT=666
      - MCPD_LOG_LEVEL=INFO
    volumes:
      - ./data:/app/data
    restart: unless-stopped

⁠🔑 Getting Your API Key

After starting the container, get your API key from the logs:

docker logs <container-name> | grep "First API key"

⁠🛠️ Features

• ✅ Multi-Platform Support: AMD64, ARM64, ARM v7
• ✅ API Key Authentication: Secure access control
• ✅ Health Monitoring: Built-in health check endpoint
• ✅ Extensible Tools: Easy to add custom MCP tools
• ✅ Console Tool: Execute host machine commands
• ✅ Configurable Logging: Timestamped logs with levels
• ✅ Non-Root User: Runs securely as non-privileged user
• ✅ Production Ready: Health checks and restart policies

⁠📋 Environment Variables

⁠🔗 Links

• Source Code: https://github.com/antpavlenko/mcp_dockerized⁠
• Documentation: https://github.com/antpavlenko/mcp_dockerized/blob/main/README.md⁠
• Issues: https://github.com/antpavlenko/mcp_dockerized/issues⁠
• License: MIT