GitHub-Jira MCP Server

A comprehensive Model Context Protocol (MCP) server that provides secure integration between GitHub and Jira with proper permission controls and security enforcement.

🛠️ Installation

Prerequisites

• Python 3.11+
• GitHub Personal Access Token
• Jira OAuth App Credentials

Setup

1. Clone the repository

   git clone <your-repo>
   cd mcp-servers
   

2. Install dependencies

   uv sync
   

3. Configure environment variables

   cp env.example .env
   # Edit .env with your actual credentials
   

4. Set up credentials

   GitHub:

   • Go to GitHub Settings > Tokens
   • Generate a new personal access token
   • Required scopes: repo (for private repos), public_repo (for public repos)

   Jira:

   • Go to Atlassian Developer Console
   • Create a new OAuth app
   • Set redirect URI to: http://localhost:8080/callback
   • Note your Jira instance URL, client ID, and client secret

🔧 Configuration

Environment Variables

Create a .env file in your project root:

# GitHub Configuration
GITHUB_TOKEN=ghp_your_github_token_here

# Jira OAuth Configuration
JIRA_URL=https://your-domain.atlassian.net
JIRA_CLIENT_ID=your_jira_oauth_client_id_here
JIRA_CLIENT_SECRET=your_jira_oauth_client_secret_here

# Optional: Jira Access Tokens (will be obtained automatically via OAuth)
JIRA_ACCESS_TOKEN=
JIRA_REFRESH_TOKEN=

# Optional: Logging
LOG_LEVEL=INFO

MCP Client Configuration

Add this to your MCP client configuration:

{
  "mcpServers": {
    "github-jira": {
      "command": "python",
      "args": ["mcp_github_jira_server.py"],
      "env": {
        "GITHUB_TOKEN": "your_token_here",
        "JIRA_URL": "https://your-domain.atlassian.net",
        "JIRA_CLIENT_ID": "your_jira_oauth_client_id_here",
        "JIRA_CLIENT_SECRET": "your_jira_oauth_client_secret_here"
      }
    }
  }
}

📚 Usage

Starting the Server

python mcp_github_jira_server.py

Available Tools

GitHub Tools

• github_read_file(owner, repo, path) - Read file content with security checks
• github_create_issue(owner, repo, title, body, labels) - Create issues in own repos
• github_create_pull_request(owner, repo, title, body, head, base) - Create PRs in own repos
• github_delete_file(owner, repo, path, message, sha) - Delete files from own repos
• check_github_permissions() - Check current GitHub permissions

Jira Tools

• jira_create_issue(project_key, summary, description, issue_type) - Create issues
• jira_search_issues(jql, max_results) - Search issues using JQL
• jira_update_issue(issue_key, updates) - Update issue fields
• jira_add_comment(issue_key, comment) - Add comments to issues
• jira_transition_issue(issue_key, transition_id) - Move issues through workflows
• check_jira_permissions() - Check current Jira permissions
• setup_jira_oauth() - Setup Jira OAuth authentication

Available Resources

GitHub Resources

• github://{owner}/{repo} - Repository information
• github://{owner}/{repo}/files/{path} - File content

Jira Resources

• jira://projects/{project_key} - Project information
• jira://issues/{issue_key} - Issue details

Available Prompts

• check_repository_security_permissions - Check GitHub permissions
• read_file_from_github_repo - Read files from GitHub
• create_jira_issue_in_project - Create Jira issues
• update_jira_issue_workflow - Update workflow states
• github_repository_management - Manage GitHub repos
• jira_project_workflow_management - Manage Jira projects
• setup_jira_oauth_authentication - Setup Jira OAuth authentication