MCP 服务器

DevOps MCP Hub

An AI-powered MCP server unifying Jira, GitHub, and Confluence integrations, enabling sprint health analysis, smart issue creation, and release notes generation via natural language.

README

🚀 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

Fork the repository
Create feature branch (git checkout -b feature/amazing-feature)
Commit changes (git commit -m 'Add amazing feature')
Push to branch (git push origin feature/amazing-feature)
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