mcp-gitlab-jira

A Model Context Protocol (MCP) server for GitLab and Jira integration. This server allows AI agents like gemini-cli to interact with your GitLab and Jira instances.

• Projects: List all accessible projects or filter them by name.
• Merge Requests: List merge requests for a project, get detailed information (including diffs), add comments, and assign reviewers.
• Pipeline/CI/CD: Get pipeline status, trigger/retry/cancel pipelines, get job details and logs.
• Branch Management: List, create, delete branches and get branch details.
• Issue Management: Create, list, update, close issues and manage comments.
• Files: Get the content of a specific file at a given SHA.
• Releases: List all releases for a project or filter them since a specific version.
• Users: List project members, get a user's ID by username, and get user activities.

• Tickets: Get detailed information about a ticket, get comments, add comments, search for tickets using JQL, create new tickets, get available transitions, update tickets, and transition tickets to a new status.
• Project Management: Get all projects, project details, components, and versions.

• Node.js 18+
• GitLab Personal Access Token with API access
• Jira API Token
• Access to a GitLab instance (on-premise or GitLab.com)
• Access to a Jira instance

1. Install the package globally:

   npm i -g mcp-gitlab-jira

1. Set up environment variables:

   # GitLab
   export GITLAB_URL="https://your-gitlab-instance.com"
   export GITLAB_ACCESS_TOKEN="your-personal-access-token"

   # Jira
   export ATLASSIAN_SITE_NAME="your-atlassian-site-name"
   export ATLASSIAN_USER_EMAIL="your-email@example.com"
   export ATLASSIAN_API_TOKEN="your-jira-api-token"

1. Test the server manually:

   # Test that the server starts without errors
   echo '{"json