🚢 deployment-mcp

MCP Server for automated deployments and build jobs with CI/CD integration.

Features

Core Features

• 🚀 deploy - Start deployment to environment
• 🔙 rollback - Rollback to previous version
• 📊 get_status - Get deployment status
• 📋 list_deployments - List deployment history
• 🔄 trigger_build - Trigger CI/CD build

Advanced Features

• 📊 Build log retrieval
• 💬 Notifications to issues/MRs
• 🐳 Docker/Kubernetes deployment support
• 🔐 Secrets management integration
• 📈 Deployment metrics

Installation

npm install
npm run build

Configuration

Environment variables:

• DEPLOY_TYPE - Deployment type (docker, k8s, ssh, custom) (default: custom)
• DEPLOY_SCRIPT - Path to deployment script
• K8S_CONFIG - Path to Kubernetes config (if using k8s)
• DOCKER_HOST - Docker host URL (if using docker)
• GITLAB_URL - GitLab instance URL (for CI/CD integration)
• GITLAB_TOKEN - GitLab API token
• GITHUB_TOKEN - GitHub token (for Actions integration)

Usage

export DEPLOY_TYPE=docker
export DEPLOY_SCRIPT=/path/to/deploy.sh
npm start

Examples

Deploy to environment

{
  "tool": "deploy",
  "arguments": {
    "environment": "production",
    "version": "v1.2.3"
  }
}

Rollback deployment

{
  "tool": "rollback",
  "arguments": {
    "environment": "production"
  }
}

Get deployment status

{
  "tool": "get_status",
  "arguments": {
    "environment": "production"
  }
}

Deployment Types

Docker

Deploy using Docker Compose or Docker Swarm.

Kubernetes

Deploy to Kubernetes cluster using kubectl.

SSH

Deploy via SSH to remote servers.

Custom Script

Run custom deployment scripts.

Security

• Never log or expose secrets in responses
• Use environment variables for sensitive data
• Validate all inputs before execution
• Implement proper access control

License

MIT