GitLab 및 Jira 통합을 위한 Model Context Protocol (MCP) 서버. 이 서버는 GitLab 및 Jira 인스턴스와 상호 작용하는 gemini-cli와 같은 AI 에이전트를 허용합니다.

특징

지트랩

-Projects: 모든 접근 가능한 프로젝트를 나열하거나 이름을 필터링합니다.

• Merge Requests: 프로젝트에 대한 통합 요청 목록, 자세한 정보를 얻을 (diffs 포함), Add comments, and assign reviewers.
• **Pipeline/CI/CD **: 파이프라인 상태, 방아쇠/retry/cancel 파이프라인을 얻으십시오, 일 세부사항 및 통나무를 얻으십시오.
• Branch Management: 목록, 생성, 삭제 지점 및 지점 정보를 얻을.
• Issue Management: 생성, 목록, 업데이트, 닫기 문제 및 관리 의견.
• Files: 주어진 SHA에 특정 파일의 내용을 가져옵니다.
• Releases: 프로젝트의 모든 릴리스를 나열하거나 특정 버전 이후 필터링합니다.
• 사용자: 프로젝트 멤버 목록은 사용자의 ID를 사용자의 ID로 가져와 사용자의 활동을 얻을 수 있습니다.

지라

• 티켓: 티켓에 대한 자세한 정보를 얻으려면, 코멘트를 추가, 코멘트를 추가, 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: