jihadkhawaja.MCP.DevOps 0.1.0

MCP.DevOps

A comprehensive Model Context Protocol (MCP) Server for automating DevOps operations and deploying applications to various cloud providers and servers. This server enables AI assistants and other MCP clients to perform sophisticated deployment automation, infrastructure management, and application lifecycle operations.

Features

Multi-Platform Deployment Support

• AWS Deployment: EC2 instances, ECS containers, Lambda functions, S3 storage
• Azure Deployment: App Service, Container Instances, Virtual Machines, Function Apps
• Linux Server Deployment: SSH-based deployment, systemd services, Nginx configuration

Development & Build Operations

• Git Operations: Clone repositories, check status, get commit information
• Build Automation: .NET build, publish, and test operations
• Docker Operations: Build images, push to registries, run containers
• Command Execution: Execute shell commands with timeout and error handling

Infrastructure Management

• Cloud Resources: Create and manage cloud infrastructure
• Container Orchestration: Deploy and manage containerized applications
• Service Management: Monitor and control system services
• Health Monitoring: Perform health checks and system monitoring

Configuration & Environment Management

• Environment Variables: Manage and retrieve environment settings
• Deployment Configurations: Create and validate deployment configurations
• Secrets Management: Handle sensitive configuration data securely

Technology Stack

• .NET 8.0: Built on the latest .NET platform
• C# 12.0: Using modern C# language features
• Model Context Protocol: Implements MCP server specification
• AWS SDK: Native AWS service integration
• Azure SDK: Native Azure service integration
• SSH.NET: Secure Shell operations for Linux deployments
• Docker.DotNet: Docker container management

Installation

Prerequisites

• .NET 8.0 SDK or later
• Compatible MCP client (Claude Desktop, VS Code with MCP extension, etc.)
• Cloud CLI tools (optional but recommended):
  • AWS CLI for AWS deployments
  • Azure CLI for Azure deployments
  • Docker for container operations

Building from Source

git clone https://github.com/jihadkhawaja/MCP.DevOps.git
cd MCP.DevOps
dotnet build

Running the Server

dotnet run --project MCP.DevOps

Docker Deployment

docker build -t mcp-devops .
docker run -it mcp-devops

Usage

MCP Client Configuration

Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "MCP.DevOps": {
      "command": "dotnet",
      "args": ["run", "--project", "path/to/MCP.DevOps.csproj"]
    }
  }
}

VS Code with MCP Extension

Configure in your MCP settings:

"servers": {
  "MCP.DevOps": {
    "type": "stdio",
    "command": "dotnet",
    "args": [
      "run",
      "--project",
      "path/to/MCP.DevOps.csproj"
    ]
  }
}

Available Tools

System & Command Operations

Git Operations

Build & Test Operations

Docker Operations

AWS Deployment Tools

Azure Deployment Tools

Linux Server Deployment Tools

Configuration & Health Tools

Example Workflows

Deploy .NET App to AWS EC2

{
  "workflow": "Deploy to AWS EC2",
  "steps": [
    {
      "tool": "ConfigureAWS",
      "params": {
        "accessKeyId": "your-access-key",
        "secretAccessKey": "your-secret-key",
        "region": "us-east-1"
      }
    },
    {
      "tool": "DotNetPublish",
      "params": {
        "projectPath": "./MyApp.csproj",
        "configuration": "Release",
        "output": "./publish"
      }
    },
    {
      "tool": "DeployToEC2",
      "params": {
        "instanceId": "i-1234567890abcdef0",
        "privateKeyPath": "./my-key.pem",
        "sourcePath": "./publish",
        "targetPath": "/home/ec2-user/myapp"
      }
    }
  ]
}

Deploy Container to Azure

{
  "workflow": "Deploy to Azure Container Instance",
  "steps": [
    {
      "tool": "AzureLogin",
      "params": {
        "clientId": "your-client-id",
        "clientSecret": "your-client-secret",
        "tenantId": "your-tenant-id"
      }
    },
    {
      "tool": "DockerBuild",
      "params": {
        "dockerfilePath": "./Dockerfile",
        "imageName": "myapp",
        "tag": "latest"
      }
    },
    {
      "tool": "DeployToContainerInstance",
      "params": {
        "containerName": "myapp-container",
        "resourceGroup": "my-resource-group",
        "image": "myregistry.azurecr.io/myapp:latest",
        "location": "eastus"
      }
    }
  ]
}

Deploy to Linux Server with Nginx

{
  "workflow": "Deploy to Linux Server",
  "steps": [
    {
      "tool": "DotNetPublish",
      "params": {
        "projectPath": "./WebApp.csproj",
        "configuration": "Release",
        "output": "./publish"
      }
    },
    {
      "tool": "DeployWebAppWithNginx",
      "params": {
        "hostname": "192.168.1.100",
        "username": "ubuntu",
        "privateKeyPath": "./server-key.pem",
        "localAppPath": "./publish",
        "remoteAppPath": "/var/www/myapp",
        "appName": "myapp",
        "domain": "myapp.example.com",
        "appPort": 5000
      }
    }
  ]
}

Security Considerations

• Credential Management: Store sensitive credentials as environment variables or use secure credential stores
• SSH Keys: Use SSH key authentication instead of passwords when possible
• Network Security: Ensure proper firewall and security group configurations
• Access Control: Use least-privilege principles for cloud service accounts
• Secrets: Never commit secrets or private keys to version control

Error Handling

All tools return structured JSON responses with error information:

Success Response

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {...},
  "timestamp": "2024-01-15T10:30:00Z"
}

Error Response

{
  "error": "Detailed error message",
  "context": {...},
  "timestamp": "2024-01-15T10:30:00Z"
}

Dependencies

• Microsoft.Extensions.Hosting (9.0.7) - Application hosting framework
• ModelContextProtocol (0.3.0-preview.2) - MCP server implementation
• AWSSDK.Core (3.7.400.63) - AWS SDK core components
• AWSSDK.EC2 (3.7.423.1) - AWS EC2 service
• AWSSDK.ECS (3.7.407.9) - AWS ECS service
• AWSSDK.Lambda (3.7.408.2) - AWS Lambda service
• Azure.Identity (1.13.1) - Azure authentication
• Azure.ResourceManager (1.14.0-beta.1) - Azure resource management
• Azure.ResourceManager.AppService (1.2.0) - Azure App Service
• Azure.ResourceManager.ContainerInstance (1.2.1) - Azure Container Instances
• SSH.NET (2024.2.0) - SSH operations
• Docker.DotNet (3.125.15) - Docker container management

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

For questions, issues, or contributions, please visit the GitHub repository or open an issue.

Note: This MCP server provides powerful DevOps automation capabilities. Ensure you understand the security implications and have proper access controls in place when deploying to production environments.