🚀 DevOps MCP Hub

AI-Powered Unified DevOps Integration for Jira, GitHub, and Confluence

A comprehensive Model Context Protocol (MCP) server that enables AI assistants to seamlessly interact with your DevOps tools. Built for the CCTECH Hackathon.

!Version !Node !License

---

✨ Features

🔧 Core Integrations

| Platform | Features | |----------|----------| | Jira | Issues, Projects, Sprints, Comments, Attachments, Worklogs | | GitHub | Repos, PRs, Commits, Branches, Actions, Releases | | Confluence | Spaces, Pages, Search, Comments, Publishing |

🤖 AI-Powered Features

• 🏥 Sprint Health Analyzer - Comprehensive sprint metrics with risk analysis and recommendations
• 🧠 Smart Issue Creator (NLP) - Create issues from natural language with AI-suggested properties
• 📊 Team Workload Dashboard - Visualize team capacity and identify bottlenecks
• ⏱️ Time Tracking - Full worklog support with team summaries
• 📝 Release Notes Generator - Auto-generate release notes from Jira + GitHub data

💬 MCP Prompts

Pre-built conversational workflows:

• Sprint Review Analysis
• Natural Language Issue Creation
• Team Standup Generation
• Workload Analysis
• Release Notes Generation

---

🚀 Quick Start

Prerequisites

• Node.js 18+
• npm or yarn
• Access to Jira (required) + GitHub/Confluence (optional)

Installation

# Clone the repository
git clone https://github.com/your-org/devops-mcp-hub.git
cd devops-mcp-hub

# Install dependencies
npm install

# Configure environment
cp .env.example .env
# Edit .env with your credentials

# Build
npm run build

Configuration

Edit .env file with your credentials:

# Jira (Required)
JIRA_BASE_URL=https://your-company.atlassian.net
JIRA_EMAIL=your.email@company.com
JIRA_API_TOKEN=your_api_token

# GitHub (Optional)
GITHUB_TOKEN=your_github_token

# Confluence (Optional)
CONFLUENCE_BASE_URL=https://your-company.atlassian.net
CONFLUENCE_EMAIL=your.email@company.com
CONFLUENCE_API_TOKEN=your_api_token

Add to Cursor

Add to your ~/.cursor/mcp.json:

{
  "mcpServers": {
    "devops-hub": {
      "command": "node",
      "args": ["C:/path/to/devops-mcp-hub/dist/index.js"],
      "env": {
        "JIRA_BASE_URL": "https://your-company.atlassian.net",
        "JIRA_EMAIL": "your.email@company.com",
        "JIRA_API_TOKEN": "your_api_token",
        "GITHUB_TOKEN": "your_github_token",
        "CONFLUENCE_BASE_URL": "https://your-company.atlassian.net",
        "CONFLUENCE_EMAIL": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token"
      }
    }
  }
}

---

🐳 Docker Deployment

Build and Run

# Build Docker image
docker build -t devops-mcp-hub .

# Run with environment file
docker run --env-file .env devops-mcp-hub

# Or with docker-compose
docker-compose up -d

Using Pre-built Image

# Pull from registry (when published)
docker pull your-registry/devops-mcp-hub:latest

# Run
docker run --env-file .env your-registry/devops-mcp-hub:latest

For Teams

Share the Docker image with your team:

# Save image to file
docker save devops-mcp-hub:latest | gzip > devops-mcp-hub.tar.gz

# Load on another machine
gunzip -c devops-mcp-hub.tar.gz | docker load

# Run with their own .env file
docker run --env-file .env devops-mcp-hub:latest

---

📚 Available Tools

Jira Tools

| Tool | Description | |------|-------------| | get_issue | Get issue details | | search_issues | Search with JQL | | create_issue | Create new issue | | update_issue | Update issue | | delete_issue | Delete issue | | transition_issue | Change status | | add_comment | Add comment | | get_comments | Get comments | | assign_issue | Assign to user | | get_projects | List projects | | get_boards | List boards | | get_sprints | List sprints | | get_sprint_issues | Sprint issues | | get_my_issues | My assigned issues | | add_worklog | Log time | | get_worklogs | Get worklogs | | get_time_tracking | Time tracking info |

AI Analytics Tools

| Tool | Description | |------|-------------| | analyze_sprint_health | Sprint health with metrics | | get_workload_dashboard | Team workload analysis | | analyze_issue_text | NLP issue analysis | | create_smart_issue | AI-powered issue creation | | generate_release_notes | Auto-generate release notes | | get_team_worklogs | Team time summary |

GitHub Tools

| Tool | Description | |------|-------------| | github_get_repos | List repositories | | github_get_repo | Repository details | | github_get_commits | Get commits | | github_get_prs | Get pull requests | | github_compare | Compare branches | | github_get_file | Get file content | | github_get_workflows | GitHub Actions | | github_get_releases | Get releases |

Confluence Tools

| Tool | Description | |------|-------------| | confluence_get_spaces | List spaces | | confluence_get_page | Get page | | confluence_search | Search content | | confluence_create_page | Create page | | confluence_get_space_pages | Pages in space | | publish_release_notes_to_confluence | Publish release notes |

---

💡 Usage Examples

Sprint Health Analysis

Analyze the health of sprint 123 on board 456

The AI will provide:

• Health score (0-100)
• Issue breakdown
• Risk identification
• Actionable recommendations

Smart Issue Creation

Create an issue: We need to fix the login page that crashes when users
enter special characters in the password field. This is urgent and
affecting production users.

AI automatically detects:

• Type: Bug
• Priority: Critical
• Labels: frontend, security
• Similar existing issues

Release Notes Generation

Generate release notes for version 2.0.0 of project MYPROJ

Generates comprehensive release notes with:

• Features, improvements, bug fixes
• Breaking changes warnings
• Contributor acknowledgments
• GitHub statistics (if configured)

Workload Dashboard

Show me the team workload for project MYPROJ

Provides:

• Per-member workload metrics
• Balance score
• Bottleneck identification
• Redistribution recommendations

---

🏗️ Architecture

┌─────────────────────────────────────────────────────────────┐
│                     DevOps MCP Hub                          │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         │
│  │   Jira      │  │   GitHub    │  │ Confluence  │         │
│  │   Client    │  │   Client    │  │   Client    │         │
│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘         │
│         │                │                │                 │
│         └────────────────┼────────────────┘                 │
│                          │                                  │
│                  ┌───────▼───────┐                          │
│                  │  AI Analytics │                          │
│                  │    Engine     │                          │
│                  └───────┬───────┘                          │
│                          │                                  │
│         ┌────────────────┼────────────────┐                 │
│         │                │                │                 │
│  ┌──────▼──────┐  ┌──────▼──────┐  ┌──────▼──────┐         │
│  │   Sprint    │  │    Smart    │  │   Release   │         │
│  │   Health    │  │    Issue    │  │    Notes    │         │
│  └─────────────┘  └─────────────┘  └─────────────┘         │
│                                                             │
├─────────────────────────────────────────────────────────────┤
│                     MCP Protocol Layer                       │
│              (Tools, Resources, Prompts)                     │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
                    ┌─────────────────┐
                    │   AI Assistant  │
                    │  (Cursor, etc)  │
                    └─────────────────┘

---

🔐 Security

• No hardcoded secrets - All credentials via environment variables
• Non-root Docker - Runs as unprivileged user
• Read-only filesystem - Container filesystem is immutable
• Input validation - All inputs validated with Zod schemas
• HTTPS only - All API calls use secure connections

---

🛠️ Development

# Run in development mode
npm run dev

# Build
npm run build

# Start production
npm start

Project Structure

devops-mcp-hub/
├── src/
│   ├── index.ts           # Main MCP server
│   ├── jira-client.ts     # Jira API client
│   ├── github-client.ts   # GitHub API client
│   ├── confluence-client.ts # Confluence API client
│   └── ai-analytics.ts    # AI-powered analytics
├── dist/                  # Compiled output
├── Dockerfile             # Docker configuration
├── docker-compose.yml     # Docker Compose
├── package.json
├── tsconfig.json
└── README.md

---

🤝 Contributing

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

---

📄 License

MIT License - see LICENSE file

---

🏆 CCTECH Hackathon

Built with ❤️ for the CCTECH Hackathon by the DevOps MCP Hub Team

Features Implemented:

• ✅ Jira MCP Server with full CRUD operations
• ✅ GitHub Integration
• ✅ Confluence Integration
• ✅ AI Sprint Health Analyzer
• ✅ Smart Issue Creator (NLP)
• ✅ Team Workload Dashboard
• ✅ Time Tracking (Worklogs)
• ✅ Release Notes Generator
• ✅ Docker Deployment
• ✅ Cross-platform support (Cloud + Server)

---

📞 Support

• Create an issue on GitHub
• Check existing documentation
• Review environment configuration