# 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
