DevOps Helper MCP

An MCP server and slash commands for Claude Code to help onboard developers with Git, Docker, GitHub Actions, and GitHub Container Registry.

Features

MCP Tools (Auto-available in Claude Code)

Tool	Description
`git_status_explained`	Git status with beginner-friendly explanations
`git_branch_explained`	Show branches with workflow explanation
`git_commit_guided`	Guide through creating proper commits
`docker_check_setup`	Verify Docker installation and setup
`docker_analyze_project`	Detect project type, generate Dockerfile
`docker_build`	Build Docker image with validation
`ghcr_login_guide`	Step-by-step GHCR authentication
`ghcr_push`	Tag and push to GitHub Container Registry
`github_actions_create_ci`	Generate CI/CD workflow YAML
`github_secrets_list`	List repository and environment secrets
`github_secrets_set`	Securely store a secret in GitHub
`github_secrets_delete`	Remove a secret
`github_secrets_guide`	Explain secrets and common patterns
`sonarcloud_setup_guide`	Guide through SonarCloud setup
`sonarcloud_create_config`	Generate sonar-project.properties
`sonarcloud_create_workflow`	Generate CI workflow with SonarCloud
`azure_setup_guide`	Guide through Azure container deployment
`azure_check_cli`	Verify Azure CLI installation
`azure_acr_setup`	Create Azure Container Registry
`azure_container_apps_deploy`	Deploy to Azure Container Apps
`azure_create_workflow`	Generate Azure deployment workflow
`azure_secrets_setup`	Configure GitHub secrets for Azure
`dev_onboarding_check`	Full environment verification

Slash Commands (Per-project)

Command	Description
`/onboard-dev`	Complete developer environment setup
`/docker-setup`	Create Dockerfile for any project
`/github-pr`	Walk through creating a pull request
`/ghcr-push`	Push Docker image to GHCR
`/github-actions`	Create CI/CD pipeline
`/github-secrets`	Manage GitHub Actions secrets
`/sonarcloud`	Set up SonarCloud code analysis
`/azure-deploy`	Deploy containers to Azure
`/git-help`	Contextual git assistance

Installation

Quick Install

cd /app/devops-helper-mcp
chmod +x install.sh
./install.sh

Manual Install

Install dependencies:

npm install

Add to Claude Code settings (~/.claude/settings.json):

{
  "mcpServers": {
    "devops-helper": {
      "command": "node",
      "args": ["/app/devops-helper-mcp/src/index.js"]
    }
  }
}

Restart Claude Code

Install Slash Commands in a Project

cd /path/to/your/project
node /app/devops-helper-mcp/scripts/install-commands.js

This copies the .claude/commands/ folder to your project.

Usage Examples

Onboarding a New Developer

User: I just joined the team and need to set up my environment
Claude: Let me run a full environment check...
        [Uses dev_onboarding_check tool]
        [Guides through fixing any issues]

Creating a Docker Image

User: /docker-setup
Claude: [Analyzes project]
        [Generates appropriate Dockerfile]
        [Guides through build and run]

First Pull Request

User: /github-pr
Claude: [Checks git status]
        [Helps create feature branch if needed]
        [Guides through commit and PR creation]

Setting Up CI/CD

User: /github-actions
Claude: [Detects project type]
        [Generates workflow YAML]
        [Explains each section]
        [Helps commit and push]

Project Types Supported

Java (Maven & Gradle)
Node.js
Python
Go
Rust

Requirements

Node.js 18+
Claude Code CLI
Git
Docker (for Docker-related features)
GitHub CLI gh (for GitHub features)

Contributing

Fork the repository
Create a feature branch
Make your changes
Submit a pull request

License

MIT