mcp-gitlab-jira-onprem

MCP-сервер для GitLab и Jira Server / Data Center.

Форк mcp-gitlab-jira с правками под on-prem:

Подходит для внутренних инстансов вроде https://jira.example.com + self-hosted GitLab.

Требования

• Node.js 18+

• GitLab Personal Access Token (API)

• Jira Server/DC Personal Access Token
  Profile → Personal Access Tokens → Create
  Проверка:

curl -sS -o /dev/null -w "%{http_code}\n" \
  -H "Authorization: Bearer $ATLASSIAN_API_TOKEN" \
  -H "Accept: application/json" \
  "$ATLASSIAN_SITE_NAME/rest/api/2/myself"
# ожидаем 200

Cloud API token (ATATT…) и Basic email:token для on-prem не подойдут.

Related MCP server: GitLab MCP

Установка

Вариант A — из git

npm i -g git+ssh://git@YOUR_GITHOST/YOUR_GROUP/mcp-gitlab-jira-onprem.git
# или
npm i -g /path/to/mcp-gitlab-jira-onprem

Проверка:

which mcp-gitlab-jira-onprem
mcp-gitlab-jira-onprem   # должен стартовать и ждать stdio; Ctrl+C

Вариант B — локально без глобальной установки

git clone <repo-url> ~/tools/mcp-gitlab-jira-onprem
cd ~/tools/mcp-gitlab-jira-onprem
npm install
npm run build

В mcp.json укажите абсолютный путь к dist/index.js (см. ниже).

Переменные окружения

*нужны для соответствующей половины инструментов; можно поднять только GitLab или только Jira.

Положите их в ~/.zshrc / ~/.bashrc и перезапустите Cursor из окружения, где они видны:

export GITLAB_URL="https://gitlab.example.com"
export GITLAB_ACCESS_TOKEN="glpat-…"
export ATLASSIAN_SITE_NAME="https://jira.example.com"
export ATLASSIAN_API_TOKEN="ваш-pat"

Либо пропишите env прямо в mcp.json (удобно шарить шаблон, секреты — каждый себе).

Cursor: ~/.cursor/mcp.json

{
  "mcpServers": {
    "gitlab-jira-mcp": {
      "command": "mcp-gitlab-jira-onprem",
      "args": [],
      "env": {
        "GITLAB_URL": "https://gitlab.example.com",
        "GITLAB_ACCESS_TOKEN": "REPLACE_ME",
        "ATLASSIAN_SITE_NAME": "https://jira.example.com",
        "ATLASSIAN_API_TOKEN": "REPLACE_ME"
      }
    }
  }
}

Без глобальной установки:

{
  "mcpServers": {
    "gitlab-jira-mcp": {
      "command": "node",
      "args": ["/home/YOU/tools/mcp-gitlab-jira-onprem/dist/index.js"],
      "env": {
        "GITLAB_URL": "https://gitlab.example.com",
        "GITLAB_ACCESS_TOKEN": "REPLACE_ME",
        "ATLASSIAN_SITE_NAME": "https://jira.example.com",
        "ATLASSIAN_API_TOKEN": "REPLACE_ME"
      }
    }
  }
}

После правок: полностью перезапустите Cursor (Reload Window часто оставляет старый MCP-процесс).

Сеть / VPN

Если Jira доступна только в корпоративной сети / без VPN-туннеля:

1. Убедитесь, что curl …/myself = 200 из того же окружения, что и Cursor.

2. При split-tunnel (Nekoray и т.п.) добавьте jira.example.com в direct/bypass, иначе TLS/auth могут вести себя иначе, чем в браузере.

Отличия от upstream

См. CHANGELOG.md. Кратко:

1. Jira auth: Bearer PAT

2. Jira client: Version2Client

3. Agile REST: Bearer

4. Search: классический /rest/api/2/search

5. Комментарии: plain string body (не ADF)

GitLab-часть без изменений по смыслу.

Миграция со старых ручных патчей: docs/MIGRATION.md.

Разработка

npm install
npm run build
npm start   # stdio MCP

Исходники — src/, артефакт — dist/.

Лицензия

MIT (как у upstream). Upstream: hainanzhao/mcp-gitlab-jira / npm mcp-gitlab-jira@0.1.9.