Q Unified MCP Server

A unified Model Context Protocol (MCP) server that combines Jira, Bitbucket, Jenkins, and Ticket Automation functionality into a single comprehensive package.

Features

Jira Integration (Advanced)

• Basic Operations: Get issue details, search issues, create issues, add comments, transition issues
• User Management: Get users, search users, manage user assignments
• Project Management: Get projects, components, versions, create new projects
• Agile/Scrum: Manage boards, sprints, and sprint issues
• Issue Management: Advanced issue operations including worklogs, history, comments, linking
• Filters & Dashboards: Create and manage filters and dashboards
• Metadata: Access priorities, statuses, issue types

Bitbucket Integration (Advanced)

• Repository Management: List workspaces, repositories, branches, commits, tags
• Pull Request Operations: Create, manage, approve, merge, decline, reopen PRs
• File Operations: Get file content, diffs, and code search
• Build Integration: Manage build statuses and CI/CD integration
• Webhooks: Create and manage repository webhooks
• Permissions: Manage repository permissions and access control
• Analytics: Repository insights, statistics, and code analytics

Jenkins Integration (Advanced)

• Build Management: Trigger, monitor, stop builds, get build logs and artifacts
• Job Management: List jobs, get configurations, copy, enable/disable jobs
• Pipeline Operations: Manage pipeline stages, steps, inputs, and automation
• System Management: Manage nodes, views, plugins, system information
• Testing & Coverage: Get test results, code coverage, and quality metrics
• Artifacts: Download and manage build artifacts
• Advanced Features: Queue management, credentials, folders, load statistics

Ticket Automation (NEW!)

• Intelligent Analysis: Auto-analyze Jira tickets to extract version, type, and components
• Repository Detection: Automatically discover affected repositories based on ticket content
• Code Scanning: Deep-scan repositories for files related to specific tickets
• Workflow Automation: Complete end-to-end workflows from ticket to deployment
• Multi-Repo Support: Handle changes across multiple repositories simultaneously
• Smart Detection: Automatically detect if issues originate from library dependencies
• Git Integration: Automated branch creation, PR generation, and git operations
• Jira Integration: Move tickets through workflow states, add RCA comments, format commits

Cross-Platform Workflow Automation

• CI/CD Pipelines: Complete feature branch deployment automation
• Hotfix Management: Priority hotfix deployment with auto-merge capabilities
• Release Management: Automated release creation, tagging, and coordination
• Incident Response: Automated incident handling and escalation workflows
• Code Review: Automated code review processes and comment generation
• Quality Gates: Automated quality checks and validation pipelines

Installation

Via npm (recommended)

npm install -g q-unified-mcp

From source

git clone https://github.com/user/q-unified-mcp.git
cd q-unified-mcp
npm install
npm run build

Configuration

Create a .env file based on .env.example:

cp .env.example .env

Update the .env file with your credentials:

# Jira Configuration
JIRA_BASE_URL=https://your-jira-instance.com
JIRA_API_TOKEN=your_jira_api_token_here

# Bitbucket Server (Stash) Configuration
BITBUCKET_URL=https://your-bitbucket-instance.com
BITBUCKET_API_TOKEN=your_bitbucket_api_token_here
[email protected]

# Jenkins Configuration
JENKINS_URL=https://your-jenkins-instance.com
JENKINS_USER=your_jenkins_username
JENKINS_API_TOKEN=your_jenkins_api_token_here

Usage

Development Mode

npm run dev

Production Mode

npm start

Global Installation (from source)

npm install -g .
q-unified-mcp

Via npx (no install required)

npx q-unified-mcp

MCP Client Configuration

Add this to your MCP client configuration:

{
  "mcpServers": {
    "q-unified": {
      "command": "npx",
      "args": ["-y", "q-unified-mcp"],
      "disabled": false,
      "env": {
        "JIRA_BASE_URL": "https://your-jira-instance.com",
        "JIRA_API_TOKEN": "your_jira_api_token",
        "BITBUCKET_URL": "https://your-bitbucket-instance.com",
        "BITBUCKET_API_TOKEN": "your_bitbucket_api_token",
        "BITBUCKET_USER_EMAIL": "[email protected]",
        "JENKINS_URL": "https://your-jenkins-instance.com",
        "JENKINS_USER": "your_jenkins_username",
        "JENKINS_API_TOKEN": "your_jenkins_api_token"
      }
    }
  }
}

Or if installed locally:

{
  "mcpServers": {
    "q-unified": {
      "command": "node",
      "args": ["/path/to/q-unified-mcp/dist/index.js"],
      "disabled": false,
      "env": {
        "JIRA_BASE_URL": "https://your-jira-instance.com",
        "JIRA_API_TOKEN": "your_jira_api_token",
        "BITBUCKET_URL": "https://your-bitbucket-instance.com",
        "BITBUCKET_API_TOKEN": "your_bitbucket_api_token",
        "BITBUCKET_USER_EMAIL": "[email protected]",
        "JENKINS_URL": "https://your-jenkins-instance.com",
        "JENKINS_USER": "your_jenkins_username",
        "JENKINS_API_TOKEN": "your_jenkins_api_token"
      }
    }
  }
}

Available Tools

Jira Tools (20+ tools)

Basic Operations:

• jira_get_issue - Get details of a specific Jira issue
• jira_search_issues - Search for Jira issues using JQL
• jira_create_issue - Create a new Jira issue
• jira_add_comment - Add a comment to a Jira issue
• jira_transition_issue - Transition a Jira issue to a new status
• jira_get_projects - Get all Jira projects
• jira_get_transitions - Get available transitions for a Jira issue

Advanced Operations:

• jira_get_users - Get all Jira users
• jira_search_users - Search for Jira users
• jira_get_project_components - Get components for a Jira project
• jira_get_project_versions - Get versions for a Jira project
• jira_get_boards - Get all Jira boards
• jira_get_board_sprints - Get sprints for a Jira board
• jira_get_sprint_issues - Get issues in a sprint
• jira_get_issue_comments - Get comments for a Jira issue
• jira_get_issue_history - Get history/changes for a Jira issue
• jira_get_issue_worklog - Get worklog for a Jira issue
• jira_add_worklog - Add worklog entry to a Jira issue
• jira_assign_issue - Assign a Jira issue to a user
• jira_update_issue - Update fields on a Jira issue
• jira_get_filters - Get favorite Jira filters
• jira_create_filter - Create a new Jira filter
• jira_get_dashboards - Get all Jira dashboards
• jira_get_dashboard - Get a specific Jira dashboard
• jira_link_issues - Link two Jira issues
• jira_get_priorities - Get all Jira priorities
• jira_get_statuses - Get all Jira statuses
• jira_get_issue_types - Get all Jira issue types
• jira_create_project - Create a new Jira project

Bitbucket Tools (25+ tools)

Repository Management:

• bitbucket_get_workspaces - List all Bitbucket workspaces
• bitbucket_get_repositories - List repositories in a workspace
• bitbucket_get_branches - Get branches in a repository
• bitbucket_get_commits - Get commits in a repository

Pull Request Operations:

• bitbucket_get_pull_requests - Get pull requests for a repository
• bitbucket_create_pull_request - Create a new pull request
• bitbucket_add_pr_comment - Add a comment to a pull request
• bitbucket_approve_pr - Approve a pull request
• bitbucket_merge_pr - Merge a pull request

Advanced Operations:

• bitbucket_get_file_content - Get file content from a repository
• bitbucket_get_commit_diff - Get diff for a specific commit
• bitbucket_get_pr_diff - Get diff for a pull request
• bitbucket_get_pr_activities - Get activities for a pull request
• bitbucket_create_branch - Create a new branch
• bitbucket_delete_branch - Delete a branch
• bitbucket_create_tag - Create a new tag
• bitbucket_get_tags - Get all tags in a repository
• bitbucket_get_repo_settings - Get repository settings
• bitbucket_update_repo_settings - Update repository settings
• bitbucket_get_webhooks - Get repository webhooks
• bitbucket_create_webhook - Create a new webhook
• bitbucket_delete_webhook - Delete a webhook
• bitbucket_get_repo_permissions - Get repository permissions
• bitbucket_add_repo_permission - Add repository permission for user
• bitbucket_get_build_status - Get build status for a commit
• bitbucket_add_build_status - Add build status for a commit
• bitbucket_get_pr_changes - Get file changes in a pull request
• bitbucket_request_pr_review - Request review for a pull request
• bitbucket_decline_pr - Decline a pull request
• bitbucket_reopen_pr - Reopen a declined pull request
• bitbucket_get_repo_insights - Get repository insights/analytics
• bitbucket_search_code - Search code in a repository
• bitbucket_get_repo_statistics - Get repository statistics

Jenkins Tools (30+ tools)

Build Management:

• jenkins_list_jobs - List all Jenkins jobs
• jenkins_get_job_status - Get detailed status of a specific Jenkins job
• jenkins_get_build_status - Get detailed status of a specific build
• jenkins_get_build_console - Get the console output of a build
• jenkins_trigger_build - Trigger a new build for a job
• jenkins_stop_build - Stop a running build
• jenkins_list_running_builds - List all currently running and queued builds
• jenkins_get_job_parameters - Get the parameters defined for a parameterized job
• jenkins_cancel_queued_build - Cancel a build that is waiting in the queue

Advanced Operations:

• jenkins_get_nodes - Get all Jenkins nodes (agents)
• jenkins_get_node_details - Get details of a specific Jenkins node
• jenkins_create_node - Create a new Jenkins node
• jenkins_delete_node - Delete a Jenkins node
• jenkins_get_views - Get all Jenkins views
• jenkins_create_view - Create a new Jenkins view
• jenkins_delete_view - Delete a Jenkins view
• jenkins_get_pipeline_stages - Get stages for a pipeline build
• jenkins_get_pipeline_steps - Get steps for a pipeline stage
• jenkins_get_build_artifacts - Get artifacts for a build
• jenkins_download_artifact - Download a specific build artifact
• jenkins_get_build_test_results - Get test results for a build
• jenkins_get_build_coverage - Get code coverage for a build
• jenkins_get_queue - Get Jenkins build queue
• jenkins_get_credentials - Get Jenkins credentials
• jenkins_create_folder - Create a Jenkins folder
• jenkins_get_plugins - Get Jenkins plugins
• jenkins_install_plugin - Install a Jenkins plugin
• jenkins_get_system_info - Get Jenkins system information
• jenkins_get_load_statistics - Get Jenkins load statistics
• jenkins_get_build_trends - Get build trends for a job
• jenkins_get_job_configuration - Get job configuration XML
• jenkins_update_job_configuration - Update job configuration
• jenkins_copy_job - Copy a Jenkins job
• jenkins_disable_job - Disable a Jenkins job
• jenkins_enable_job - Enable a Jenkins job
• jenkins_get_build_log - Get build log text
• jenkins_get_build_changes - Get changes for a build
• jenkins_replay_build - Replay a build with same configuration
• jenkins_get_pipeline_input - Get pending input for pipeline
• jenkins_submit_pipeline_input - Submit input for pipeline

Ticket Automation Tools (15+ tools)

Analysis & Planning:

• ticket_analyze - Analyze a Jira ticket to extract version, type, and details
• ticket_create_branch_plan - Create version-aware branch plan based on ticket analysis
• ticket_detect_affected_repos - Auto-discover git repos and find which are affected by the Jira ticket
• ticket_scan_code_changes - Deep-scan specific repos for files related to a ticket
• ticket_get_attachments_and_comments - Read Jira ticket attachments and all comments

Git & PR Operations:

• ticket_setup_git_branch - Setup git branch - checkout base, pull latest, create working branch
• ticket_create_pr_plan - Create pull request plan with title and description
• ticket_create_pr - Create Pull Request in Bitbucket directly via API
• ticket_format_commit_message - Generate conventional commit message format

Workflow Automation:

• ticket_complete_workflow - Complete workflow: Analyze, branch, commit, and prepare PR (full automation)
• ticket_multi_repo_workflow - Multi-repo end-to-end workflow with auto-discovery
• ticket_smart_workflow - Self-driven workflow with library dependency detection
• ticket_detect_library_issue - Detect if issue originates from a node_modules library dependency
• ticket_fix - Complete workflow: Analyze, branch, commit, and prepare PR (full automation)

Jira Integration:

• ticket_move_to_code_review - Move Jira ticket to Code Review status
• ticket_add_rca_comment - Add RCA (Root Cause Analysis) comment to Jira ticket

Workflow Automation Tools (6 tools)

• workflow_deploy_feature_branch - Deploy a feature branch through complete CI/CD pipeline
• workflow_deploy_hotfix - Deploy a hotfix with priority handling
• workflow_create_release - Create and manage a release
• workflow_handle_incident - Handle incident response workflow
• workflow_automate_code_review - Automate code review process
• workflow_run_quality_gates - Run quality gates on a branch

Development

Project Structure

src/
├── clients/
│   ├── jira-client.ts              # Jira API client
│   ├── bitbucket-client.ts         # Bitbucket API client
│   ├── jenkins-client.ts           # Jenkins API client
│   └── ticket-automation-client.ts # Ticket automation client
├── workflows.ts                    # Cross-platform workflow automation
├── types.ts                        # TypeScript type definitions
├── config.ts                       # Configuration management
└── index.ts                        # Main MCP server

Total Tools Summary

This unified MCP server provides 80+ tools across 4 major categories:

• Jira: 23 tools (basic + advanced operations)
• Bitbucket: 28 tools (repository + PR + advanced operations)
• Jenkins: 33 tools (build + system + advanced operations)
• Ticket Automation: 15 tools (analysis + workflow automation)
• Workflow Automation: 6 tools (cross-platform workflows)

Total: 105+ comprehensive DevOps automation tools

Building

npm run build

Testing

npm test

Security Notes

• Never hardcode API tokens or credentials in source files
• Store all secrets in environment variables or .env files
• Add .env to .gitignore — never commit it
• Use read-only tokens when possible
• Regularly rotate API tokens

Contributing

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

License

MIT License - see LICENSE file for details.