GitLab MCP Adapter

MCP сервер для работы с GitLab EE (Self-Hosted) или GitLab.com.

Установка и использование

Этот сервер запускается через npx без ручной установки зависимостей в проект.

Предварительные требования

1. Node.js (v18 или выше).
2. npx (идёт вместе с npm).

Конфигурация (JSON)

Добавьте этот блок в mcpServers в вашем конфигурационном файле IDE:

{
  "mcpServers": {
    "gitlab": {
      "command": "npx",
      "args": [
        "-y",
        "org-gitlab-mcp-adapter"
      ],
      "env": {
        "GITLAB_HOST": "https://gitlab.example.com",
        "GITLAB_TOKEN": "your_personal_access_token"
      }
    }
  }
}

Для быстрой проверки из терминала:

npx -y org-gitlab-mcp-adapter

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

• GITLAB_HOST: Адрес вашего GitLab сервера (например https://gitlab.example.ru).
• GITLAB_TOKEN: Ваш Personal Access Token.

Как получить токен (Personal Access Token)

1. Нажмите на свой аватар в правом верхнем углу.
2. Выберите Edit profile (Редактировать профиль) или Preferences (Настройки).
3. В левом меню выберите Access Tokens (Токены доступа).
4. Нажмите Add new token (Добавить новый токен).
5. Введите имя токена (например mcp-token).
6. Выберите Scopes (Области видимости):
   • api: Для полного доступа (чтение и запись).
   • read_api: Только для чтения.
7. Нажмите Create personal access token.
8. Скопируйте токен и используйте его в GITLAB_TOKEN.

Доступные инструменты

• gitlab_debug_env: Проверка переменных окружения.
• gitlab_selftest: Самопроверка основных запросов к GitLab API.
• gitlab_searchProjects: Поиск проектов.
• gitlab_getProject: Получение информации о проекте.
• gitlab_searchIssues: Поиск задач (issues).
• gitlab_getIssue: Получение деталей задачи.
• gitlab_searchMergeRequests: Поиск MR.
• gitlab_getMergeRequest: Получение деталей MR.
• gitlab_getFileContent: Чтение содержимого файла.
• gitlab_getTree: Список файлов и директорий в репозитории.
• gitlab_createIssue: Создание issue.
• gitlab_postIssueComment: Комментарий к issue.