# 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

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

### Manual Install

1. Install dependencies:
```bash
npm install
```

2. Add to Claude Code settings (`~/.claude/settings.json`):
```json
{
  "mcpServers": {
    "devops-helper": {
      "command": "node",
      "args": ["/app/devops-helper-mcp/src/index.js"]
    }
  }
}
```

3. Restart Claude Code

### Install Slash Commands in a Project

```bash
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

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

## License

MIT