GitLabおよびJiraの統合のためのモデルコンテキストプロトコル(MCP)サーバー。 このサーバーは、GitLab や Jira インスタンスとやりとりする gemini-cli のような AI エージェントを可能にします。

##特徴

##GitLab ########################################################################################################################################################################################################################################################### -Projects:すべてのアクセス可能なプロジェクトをリストするか、名前でフィルタリングします。 -Merge Requests:プロジェクトに対するリストマージリクエスト、詳細な情報(差分を含む)、コメントを追加し、査読者を割り当てます。

• パイプライン/CI/CD: パイプラインのステータス、トリガー/リトライ/キャセルパイプライン、ジョブの詳細とログを取得します。
• ブランチ管理: ブランチをリスト、作成、削除し、ブランチの詳細を取得します。
• 住所管理: 投稿、リスト、更新、問題のクローズ、コメントの管理 -Files:特定のSHAで特定のファイルのコンテンツを取得します。 -Releases:プロジェクトのすべてのリリースをリストするか、特定のバージョンからフィルタリングします。
• ユーザー: プロジェクトメンバーをリストし、ユーザ ID をユーザ名で取得し、ユーザアクティビティを取得します。

##Jiraさん

• チケット: チケットに関する詳細情報を入手し、コメントを入手し、コメントを追加し、JQLを使用してチケットを検索し、新しいチケットを作成したり、利用可能なトランジションを入手したり、チケットを更新したり、新しいステータスに移行したりできます.

MCP GitLab Jira Server

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.

Features

GitLab

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

Jira

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

Setup

Prerequisites

• 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

Installation

1. Install the package globally:

   npm i -g mcp-gitlab-jira
   

2. 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="[email protected]"
   export ATLASSIAN_API_TOKEN="your-jira-api-token"
   

3. Test the server manually:

   # Test that the server starts without errors
   echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}' | mcp-gitlab-jira
   

   The server should start and log “GitLab/Jira MCP server started” to stderr.

Using with MCP Clients

Configuration for gemini-cli or other MCP clients

Create or update your MCP configuration file (usually ~/.mcp/config.json or similar):

{
  "mcpServers": {
    "gitlab-jira-mcp": {
      "command": "mcp-gitlab-jira",
      "env": {
        "GITLAB_URL": "https://your-gitlab-instance.com",
        "GITLAB_ACCESS_TOKEN": "your-personal-access-token",
        "ATLASSIAN_SITE_NAME": "your-atlassian-site-name",
        "ATLASSIAN_USER_EMAIL": "[email protected]",
        "ATLASSIAN_API_TOKEN": "your-jira-api-token"
      }
    }
  }
}

Running with Docker

You can also run this MCP server in a Docker container using the pre-built image from Docker Hub.

Available Docker Images

The Docker images are automatically built and published to Docker Hub for each release: