mcp-gitlab-jira - 集成GitLab與Jira，提供項目管理等功能的MCP服務器AI代理接口

探索

MCP Gitlab Jira

GitLab和Jira集成MCP服務器，提供項目管理、合併請求、問題跟蹤等功能的AI代理交互接口

開發者工具版本控制 #項目管理 #代碼協作 #問題跟蹤 #AI集成 .TypeScript

評分 : 2.5分

下載量 : 0

更新時間 : 2025-09-03

打開站點

什麼是GitLab Jira MCP Server?

這是一個智能連接器服務器，專門為開發團隊設計，能夠將GitLab代碼管理平臺和Jira項目追蹤系統無縫連接。通過AI助手，您可以查詢項目信息、管理合併請求、跟蹤任務狀態，實現自動化協作。

如何使用GitLab Jira MCP Server?

只需配置好您的GitLab和Jira賬戶信息，AI助手就能幫您執行各種操作，比如查看代碼變更、添加代碼評論、創建Jira任務、更新任務狀態等，完全通過自然語言指令完成。

適用場景

適合軟件開發團隊、項目經理、質量保證工程師，以及任何需要同時在代碼管理和項目追蹤平臺協作的團隊成員，特別適合需要頻繁在GitLab和Jira之間切換工作的場景。

主要功能

GitLab項目管理

瀏覽所有可訪問的GitLab項目，按名稱篩選項目，快速找到您需要的代碼庫。

合併請求管理

查看合併請求詳情（包括代碼差異）、添加評論、分配評審人員，全面管理代碼審查流程。

文件內容查看

獲取特定版本的文件內容，方便查看歷史代碼或比較不同版本的變更。

版本發佈管理

查看項目的所有發佈版本，按版本號篩選，跟蹤發佈歷史。

Jira任務管理

獲取任務詳情、查看評論、添加評論、搜索任務、創建新任務，全面管理項目任務。

任務狀態流轉

查看可用狀態轉換、更新任務信息、改變任務狀態，推動任務流程前進。

用戶管理

查看項目成員、獲取用戶ID、查詢用戶活動，方便團隊協作和權限管理。

跨平臺協作

在GitLab和Jira之間無縫切換，實現代碼開發與項目管理的完美結合。

優勢

自動化協作：通過AI指令自動完成重複性操作，提高工作效率

無縫集成：深度整合GitLab和Jira，消除平臺切換的麻煩

自然語言操作：使用簡單指令即可執行復雜操作，降低使用門檻

全面覆蓋：支持GitLab和Jira的大部分常用功能

多架構支持：支持Linux和Apple Silicon設備，兼容性好

侷限性

需要API權限：需要預先配置GitLab和Jira的API訪問令牌

網絡依賴：需要穩定的網絡連接訪問GitLab和Jira實例

功能限制：某些高級功能可能受API限制無法完全實現

學習曲線：需要熟悉基本的GitLab和Jira概念才能有效使用

如何使用

安裝服務器

通過npm全局安裝MCP服務器包

配置環境變量

設置GitLab和Jira的訪問憑證和環境信息

配置MCP客戶端

在您的AI助手客戶端中添加服務器配置

開始使用

啟動AI助手，開始使用自然語言指令管理GitLab和Jira

使用案例

代碼審查助手

AI幫助您審查代碼合併請求，查看代碼差異並提出改進建議

任務狀態更新

自動更新Jira任務狀態並添加進度評論

跨平臺協作

根據GitLab的合併請求自動創建對應的Jira任務

版本發佈跟蹤

查看項目的版本發佈歷史和變更內容

常見問題

需要什麼樣的權限才能使用這個服務器？

支持自託管的GitLab和Jira實例嗎？

如果遇到連接錯誤怎麼辦？

支持哪些MCP客戶端？

Docker容器如何更新到新版本？

🚀 MCP GitLab Jira Server

MCP GitLab Jira Server 是一個用於集成 GitLab 和 Jira 的模型上下文協議（MCP）服務器。該服務器允許像 gemini-cli 這樣的 AI 代理與你的 GitLab 和 Jira 實例進行交互。

🚀 快速開始

本 MCP 服務器可幫助 AI 代理與 GitLab 和 Jira 實例交互。以下是快速開始使用它的步驟：

確保滿足所有前置條件。
完成安裝步驟，包括全局安裝包和設置環境變量。
手動測試服務器是否能正常啟動。
配置 MCP 客戶端以使用該服務器。

如果你想使用 Docker 運行服務器，可按照 Docker 相關部分的步驟操作。

✨ 主要特性

GitLab

項目管理：列出所有可訪問的項目，或按名稱過濾項目。
合併請求管理：列出項目的合併請求，獲取詳細信息（包括差異），添加評論，並分配審核人員。
文件管理：獲取指定 SHA 版本下特定文件的內容。
版本發佈管理：列出項目的所有版本發佈，或按特定版本篩選發佈。
用戶管理：列出項目成員，按用戶名獲取用戶 ID，並獲取用戶活動信息。

Jira

工單管理：獲取工單的詳細信息，獲取評論，添加評論，使用 JQL 搜索工單，創建新工單，獲取可用的工單狀態轉換，更新工單，以及將工單轉換到新狀態。

📦 安裝指南

前置條件

Node.js 18 及以上版本。
具有 API 訪問權限的 GitLab 個人訪問令牌。
Jira API 令牌。
能夠訪問 GitLab 實例（本地部署或 GitLab.com）。
能夠訪問 Jira 實例。

安裝步驟

全局安裝包：

npm i -g mcp-gitlab-jira

設置環境變量：

# 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"

手動測試服務器：

# 測試服務器是否能正常啟動
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}' | mcp-gitlab-jira

服務器應啟動並在 stderr 中記錄 "GitLab/Jira MCP server started"。

與 MCP 客戶端配合使用

gemini-cli 或其他 MCP 客戶端的配置

創建或更新你的 MCP 配置文件（通常為 ~/.mcp/config.json 或類似文件）：

{
  "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": "your-email@example.com",
        "ATLASSIAN_API_TOKEN": "your-jira-api-token"
      }
    }
  }
}

使用 Docker 運行

你也可以使用 Docker Hub 上的預構建鏡像，在 Docker 容器中運行此 MCP 服務器。

可用的 Docker 鏡像

Docker 鏡像會為每個版本自動構建併發布到 Docker Hub：

最新版本：hainanzhao/mcp-gitlab-jira:latest
特定版本：hainanzhao/mcp-gitlab-jira:v0.1.2、hainanzhao/mcp-gitlab-jira:v0.1.1 等。
查看所有可用標籤：Docker Hub - mcp-gitlab-jira

這些鏡像支持多種架構：linux/amd64 和 linux/arm64（兼容 Apple Silicon）。

使用方法

拉取並運行 Docker 容器：

docker run -d --name mcp-gitlab-jira-container \
  -e GITLAB_URL="https://your-gitlab-instance.com" \
  -e GITLAB_ACCESS_TOKEN="your-personal-access-token" \
  -e ATLASSIAN_SITE_NAME="your-atlassian-site-name" \
  -e ATLASSIAN_USER_EMAIL="your-email@example.com" \
  -e ATLASSIAN_API_TOKEN="your-jira-api-token" \
  hainanzhao/mcp-gitlab-jira:latest

可選：無持久化容器運行（一次性執行）：

docker run --rm -i \
  -e GITLAB_URL="https://your-gitlab-instance.com" \
  -e GITLAB_ACCESS_TOKEN="your-personal-access-token" \
  -e ATLASSIAN_SITE_NAME="your-atlassian-site-name" \
  -e ATLASSIAN_USER_EMAIL="your-email@example.com" \
  -e ATLASSIAN_API_TOKEN="your-jira-api-token" \
  hainanzhao/mcp-gitlab-jira:latest

與 MCP 客戶端配合使用（Docker）

你有兩種方式將 Docker 容器與 MCP 客戶端配合使用：

方式 1：使用持久化容器（推薦）

首先，按上述步驟啟動容器，然後更新你的 MCP 配置文件。由於必要的環境變量已通過 docker run 命令的 -e 標誌直接傳遞給容器，因此 env 塊為空。

{
  "mcpServers": {
    "gitlab-jira-mcp": {
      "command": "docker",
      "args": ["exec", "-i", "mcp-gitlab-jira-container", "npm", "start"],
      "env": {}
    }
  }
}

方式 2：使用一次性執行

每次 MCP 會話都運行一個新容器：

{
  "mcpServers": {
    "gitlab-jira-mcp": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "GITLAB_URL=https://your-gitlab-instance.com",
        "-e", "GITLAB_ACCESS_TOKEN=your-personal-access-token",
        "-e", "ATLASSIAN_SITE_NAME=your-atlassian-site-name",
        "-e", "ATLASSIAN_USER_EMAIL=your-email@example.com",
        "-e", "ATLASSIAN_API_TOKEN=your-jira-api-token",
        "hainanzhao/mcp-gitlab-jira:latest"
      ],
      "env": {}
    }
  }
}

💻 使用示例

基礎用法

以下是手動測試服務器啟動的示例：

echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}' | mcp-gitlab-jira

高級用法

使用 Docker 持久化容器與 MCP 客戶端配合使用

{
  "mcpServers": {
    "gitlab-jira-mcp": {
      "command": "docker",
      "args": ["exec", "-i", "mcp-gitlab-jira-container", "npm", "start"],
      "env": {}
    }
  }
}

使用 Docker 一次性執行與 MCP 客戶端配合使用

{
  "mcpServers": {
    "gitlab-jira-mcp": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "GITLAB_URL=https://your-gitlab-instance.com",
        "-e", "GITLAB_ACCESS_TOKEN=your-personal-access-token",
        "-e", "ATLASSIAN_SITE_NAME=your-atlassian-site-name",
        "-e", "ATLASSIAN_USER_EMAIL=your-email@example.com",
        "-e", "ATLASSIAN_API_TOKEN=your-jira-api-token",
        "hainanzhao/mcp-gitlab-jira:latest"
      ],
      "env": {}
    }
  }
}

📚 詳細文檔

可用工具

GitLab 工具

gitlab_get_merge_request_details：獲取 GitLab 合併請求的詳細信息，包括文件差異。
gitlab_get_file_content：獲取 GitLab 項目中指定 SHA 版本下特定文件的內容。
gitlab_add_comment_to_merge_request：向 GitLab 合併請求添加評論。可以是普通評論、對現有討論的回覆，或對特定行的內聯評論。
gitlab_list_merge_requests：列出給定 GitLab 項目的合併請求。
gitlab_assign_reviewers_to_merge_request：為 GitLab 合併請求分配審核人員。
gitlab_list_project_members：列出給定 GitLab 項目的所有成員（貢獻者）。
gitlab_list_project_members_by_project_name：按項目名稱列出給定 GitLab 項目的所有成員（貢獻者）。
gitlab_list_projects_by_name：使用模糊、不區分大小寫的匹配方式按名稱過濾 GitLab 項目。
gitlab_list_all_projects：列出所有可訪問的 GitLab 項目。
gitlab_list_all_releases：獲取給定 GitLab 項目的版本發佈信息。
gitlab_list_releases_since_version：按特定版本篩選給定 GitLab 項目的版本發佈。
gitlab_get_user_id_by_username：根據用戶名獲取 GitLab 用戶 ID。
gitlab_get_user_activities：根據用戶名獲取給定 GitLab 用戶的活動信息，可按日期過濾。

Jira 工具

jira_get_jira_ticket_details：獲取 Jira 工單的詳細信息。
jira_get_jira_ticket_comments：獲取 Jira 工單的評論。
jira_add_comment_to_ticket：向 Jira 工單添加評論。
jira_search_tickets_by_jql：使用 JQL（Jira 查詢語言）字符串搜索 Jira 工單。
jira_create_ticket：使用給定字段創建新的 Jira 工單。
jira_get_available_transitions：獲取 Jira 工單的可用狀態轉換。
jira_update_ticket：更新 Jira 工單的摘要、描述、標籤。
jira_update_custom_fields：更新 Jira 工單的自定義字段。
jira_transition_ticket：將 Jira 工單轉換到新狀態。

🔧 技術細節

項目結構

src/index.ts：主 MCP 服務器實現。
src/gitlab.service.ts：GitLab API 客戶端。
src/gitlab.ts：GitLab 類型定義。
src/jira.service.ts：Jira API 客戶端。
src/jira.ts：Jira 類型定義。
dist/：編譯後的 JavaScript 輸出。

添加新功能

向 GitLabService 或 JiraService 類添加新方法。
在 index.ts 文件的 allTools 數組中定義新工具。
在 index.ts 文件的工具處理程序中添加相應的 case 語句。
使用 npm run build 重新構建項目。

本地 Docker 開發

在推送之前，可在本地測試 Docker 構建：

# 在本地構建並測試 Docker 鏡像
./scripts/build-docker-local.sh

此腳本將構建 Docker 鏡像並運行基本測試，以確保其正常工作。

維護人員注意：有關設置自動化 Docker Hub 發佈的信息，請參閱 Docker Setup Guide。

📄 許可證

本項目採用 ISC 許可證。

🔧 故障排除

常見問題

“Cannot find module” 錯誤：如果你在本地開發，請確保已運行 npm install 和 npm run build。
身份驗證錯誤：驗證你的 GITLAB_ACCESS_TOKEN、ATLASSIAN_USER_EMAIL 和 ATLASSIAN_API_TOKEN 是否具有必要的權限。
連接錯誤：確保你的 GITLAB_URL 和 ATLASSIAN_SITE_NAME 正確且可訪問。
服務器無響應：檢查 MCP 服務器進程是否正在運行，以及配置文件中的路徑是否正確。

調試模式

要查看詳細日誌，可直接運行服務器：

export GITLAB_URL="your-url"
export GITLAB_ACCESS_TOKEN="your-token"
export ATLASSIAN_SITE_NAME="your-atlassian-site-name"
export ATLASSIAN_USER_EMAIL="your-email@example.com"
export ATLASSIAN_API_TOKEN="your-jira-api-token"
mcp-gitlab-jira