🚀 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.

---

✨ 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