gitflic-mcp

v1.0.0

Published

a month ago

MCP server for GitFlic API

Downloads

0High
0Medium
0Low

sazonovfm

mcp model-context-protocol gitflic git ai claude

gitflic-mcp

Первый и единственный MCP-сервер для GitFlic — российской платформы для хостинга Git-репозиториев.

122 инструмента покрывающий 19 категорий GitFlic API: проекты, issue, связи issue, комментарии, merge request, ветки, коммиты, файлы, теги, релизы, обсуждения, вебхуки, CI/CD, зеркалирование, команды, компании, защита окружений, реестр пакетов и другие.

Построен на TypeScript и Model Context Protocol SDK.

English documentation · GitHub-зеркало

Зачем

Единственный MCP-сервер для GitFlic. Альтернатив нет — если вам нужен AI-агент для работы с GitFlic, это он.
Широкое покрытие API. 122 инструмента из 182 задокументированных эндпоинтов — все ключевые операции для повседневной работы с репозиториями.
Готов к работе. Подключается к Claude Code, Claude Desktop, Cursor и любому другому MCP-совместимому клиенту за минуту.
Минимальные зависимости. Только MCP SDK и Zod — никаких тяжёлых фреймворков.

Установка

Требования

Node.js 18+
Токен доступа GitFlic

Через npx (рекомендуется)

Без клонирования и сборки — пакет gitflic-mcp запускается через npx. Добавьте в конфигурацию MCP-клиента:

{
  "mcpServers": {
    "gitflic": {
      "command": "npx",
      "args": ["-y", "gitflic-mcp"],
      "env": { "GITFLIC_TOKEN": "ваш_токен" }
    }
  }
}

Сборка из исходников

# GitFlic (основной)
git clone https://gitflic.ru/project/sazonovfm/gitflic-mcp.git
# или GitHub (зеркало)
git clone https://github.com/revenant20/gitflic-mcp.git

cd gitflic-mcp
npm install
npm run build

Настройка MCP-клиента

При установке через npx (см. выше) конфигурация уже готова. Для сборки из исходников укажите путь к dist/index.js. Например, для Claude Code (.mcp.json в корне проекта):

{
  "mcpServers": {
    "gitflic": {
      "command": "node",
      "args": ["/абсолютный/путь/к/gitflic-mcp/dist/index.js"],
      "env": {
        "GITFLIC_TOKEN": "ваш_токен"
      }
    }
  }
}

Токен можно получить в настройках GitFlic: Настройки → Токены доступа.

| Переменная | Описание | Обязательная | |---|---|---| | GITFLIC_TOKEN | Токен доступа GitFlic API | да | | GITFLIC_API_URL | Базовый URL API (по умолчанию https://api.gitflic.ru) | нет | | GITFLIC_CACHE_TTL_MS | TTL кеша чтений в мс (по умолчанию 60000; 0 — отключить кеш) | нет |

Инструменты

122 инструмента, сгруппированных по 19 категориям. Все параметры пагинации (page, size) опциональны: page по умолчанию 0, size по умолчанию 20 (макс. 100). Инструменты создания/обновления issue, MR и комментариев также принимают опциональный imagePaths для вложения картинок — см. раздел Картинки в текстовых полях. Все read-инструменты принимают опциональный refresh для обхода кеша — см. раздел Кеширование.

Пользователи

get_me

Получить текущего авторизованного пользователя.

Параметры: нет.

get_user

Получить пользователя по алиасу.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | userAlias | string | да | Алиас (username) пользователя |

list_user_projects

Список публичных проектов пользователя.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | userAlias | string | да | Алиас пользователя | | page | number | нет | Номер страницы (с 0) | | size | number | нет | Элементов на странице |

Проекты

list_projects

Список проектов авторизованного пользователя.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | q | string | нет | Поиск по названию | | page | number | нет | Номер страницы (с 0) | | size | number | нет | Элементов на странице |

get_project

Получить проект по владельцу и алиасу.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта |

search_projects

Поиск публичных проектов.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | q | string | нет | Поисковый запрос | | page | number | нет | Номер страницы (с 0) | | size | number | нет | Элементов на странице |

list_shared_projects

Список проектов, к которым предоставлен доступ.

create_project

Создать новый проект.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | title | string | да | Название проекта | | alias | string | да | URL-slug проекта (строчные буквы, дефисы) | | isPrivate | boolean | да | true — приватный, false — публичный | | ownerAlias | string | да | Алиас владельца (пользователь, команда или компания) | | ownerAliasType | string | нет | Тип владельца: USER (по умолчанию), TEAM, COMPANY | | language | string | нет | Язык программирования | | description | string | нет | Описание проекта |

fork_project

Создать форк проекта.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца исходного проекта | | project | string | да | Алиас исходного проекта | | title | string | да | Название форка | | alias | string | да | URL-slug форка | | isPrivate | boolean | да | true — приватный, false — публичный | | forkOwnerAlias | string | да | Алиас владельца форка | | forkOwnerAliasType | string | нет | Тип владельца форка: USER (по умолчанию), TEAM, COMPANY | | language | string | нет | Язык программирования | | description | string | нет | Описание форка |

update_project

Обновить настройки проекта (название, описание, язык, топики).

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | title | string | нет | Название проекта | | description | string | нет | Описание проекта | | language | string | нет | Язык программирования | | topics | string[] | нет | Топики проекта |

delete_project

Удалить проект. Необратимая операция — удаляет репозиторий, issue, MR и все данные.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта |

list_project_members

Список участников проекта.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | q | string | нет | Поиск по username | | page | number | нет | Номер страницы (с 0) | | size | number | нет | Элементов на странице |

invite_project_member

Добавить пользователя в проект с ролью. Приглашение отложенное — участник должен его принять.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | userAlias | string | да | Алиас пользователя | | role | string | да | Роль: GUEST/REPORTER/DEVELOPER/ADMIN/OWNER |

change_member_role

Изменить роль участника проекта. Пользователь должен уже быть участником.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | userAlias | string | да | Алиас участника | | role | string | да | Новая роль: GUEST/REPORTER/DEVELOPER/ADMIN/OWNER |

remove_project_member

Удалить участника из проекта по алиасу (аккаунт пользователя не удаляется).

invite_project_team

Добавить команду в проект с максимальной ролью. Для команды OWNER недопустим.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | teamAlias | string | да | Алиас команды | | maxRole | string | да | Макс. роль: GUEST/REPORTER/DEVELOPER/ADMIN |

change_team_role

Изменить максимальную роль команды в проекте. Команда должна быть уже добавлена.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | teamAlias | string | да | Алиас команды | | maxRole | string | да | Новая макс. роль: GUEST/REPORTER/DEVELOPER/ADMIN |

remove_project_team

Удалить команду из проекта по алиасу.

Issue

list_issues

Список issue проекта.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | page | number | нет | Номер страницы (с 0) | | size | number | нет | Элементов на странице |

get_issue

Получить issue по локальному ID.

create_issue

Создать новый issue.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | title | string | да | Заголовок | | description | string | да | Описание | | status | string | нет | Статус: OPEN (по умолчанию), IN_PROGRESS, CLOSED, COMPLETED | | assignees | string[] | нет | Алиасы пользователей для назначения | | labels | string[] | нет | UUID меток (создаются через веб-интерфейс GitFlic) |

delete_issue

Удалить issue. Необратимая операция.

list_issue_files

Список файлов, прикреплённых к issue.

link_issue_file

Прикрепить загруженный файл к issue по UUID загрузки.

Примечание: link_issue_file и unlink_issue_file не полностью протестированы — для работы требуется uploadFileUuid, а загрузка файлов через API пока не реализована в MCP-сервере.

unlink_issue_file

Отвязать файл от issue (сам файл не удаляется).

update_issue

Обновить существующий issue.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | issue_id | integer | да | Локальный ID issue | | title | string | нет | Новый заголовок | | description | string | нет | Новое описание | | status | string | нет | Новый статус: OPEN, IN_PROGRESS, CLOSED, COMPLETED | | assignees | string[] | нет | Алиасы пользователей (пустой массив — очистить) | | labels | string[] | нет | UUID меток (пустой массив — очистить) |

Связи issue

list_issue_relations

Список связей (ссылок) issue.

create_issue_relation

Создать связь между двумя issue. Обратная связь создаётся автоматически.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | issue_id | integer | да | Локальный ID исходной issue | | targetIssueUuid | string | да | UUID целевой issue (из get_issue) | | relationType | string | да | Тип связи (см. ниже) |

Типы связей: RELATED, HIERARCHY_FORWARD (дочерняя), HIERARCHY_REVERSE (родительская), AFFECTS_FORWARD, AFFECTS_REVERSE, DUPLICATE_FORWARD, DUPLICATE_REVERSE, DEPENDENCY_FORWARD (преемник), DEPENDENCY_REVERSE (предшественник), TESTED_BY_FORWARD, TESTED_BY_REVERSE, SHARED_PARAMETER_REFERENCED_BY_FORWARD, SHARED_PARAMETER_REFERENCED_BY_REVERSE, SHARED_STEP_REFERENCED_BY_FORWARD, SHARED_STEP_REFERENCED_BY_REVERSE.

delete_issue_relation

Удалить связь между issue. Обратная связь также удаляется.

Комментарии к issue

list_issue_comments

Список комментариев к issue.

add_issue_comment

Добавить комментарий к issue.

edit_issue_comment

Редактировать комментарий к issue. Полностью заменяет текст.

delete_issue_comment

Удалить комментарий к issue. Необратимая операция.

Файлы репозитория

get_file_content

Получить содержимое файла (до 15 МБ, только текстовые).

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | file | string | да | Путь к файлу (например src/index.ts) | | commitHash | string | да | Хеш коммита или имя ветки |

list_files

Список файлов и директорий по указанному пути.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | filepath | string | нет | Путь к директории (пусто для корня) | | branch | string | нет | Имя ветки |

list_files_recursive

Рекурсивный список файлов (дерево репозитория).

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | directory | string | нет | Корневая директория | | commitHash | string | нет | Хеш коммита или имя ветки | | depth | number | нет | Глубина рекурсии (0–10) |

Merge Request

list_merge_requests

Список merge request проекта.

get_merge_request

Получить merge request по локальному ID.

find_mr_by_commit

Найти merge request, содержащий указанный коммит.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | commit | string | да | Хеш коммита | | status | string | нет | Фильтр по статусу: OPENED, MERGED, CLOSED, CANCELLED (GitFlic использует OPENED, не OPEN) |

create_merge_request

Создать merge request.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | title | string | да | Заголовок | | description | string | да | Описание | | sourceBranch | string | да | Исходная ветка | | targetBranch | string | да | Целевая ветка | | squashCommit | boolean | нет | Сжать коммиты при слиянии | | removeSourceBranch | boolean | нет | Удалить исходную ветку после слияния |

update_merge_request

Обновить merge request.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | mr_uuid | string | да | UUID merge request (из ответа get_merge_request) | | title | string | да | Заголовок | | targetBranch | string | да | Целевая ветка | | description | string | нет | Описание | | squashCommit | boolean | нет | Сжать коммиты при слиянии | | removeSourceBranch | boolean | нет | Удалить исходную ветку после слияния |

approve_merge_request

Одобрить или отменить одобрение merge request (переключатель).

merge_merge_request

Выполнить слияние merge request.

close_merge_request

Закрыть merge request.

cancel_merge_request

Отменить merge request.

Обсуждения MR

list_mr_discussions

Список обсуждений merge request.

get_mr_discussion

Получить обсуждение по UUID.

create_mr_discussion

Создать обсуждение (общий комментарий или к строке кода).

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | mr_id | integer | да | Локальный ID merge request | | message | string | да | Текст сообщения | | oldPath | string | нет | Путь к файлу (старая версия), для комментария к коду | | newPath | string | нет | Путь к файлу (новая версия), для комментария к коду | | oldLine | integer | нет | Номер строки (старая версия) | | newLine | integer | нет | Номер строки (новая версия) |

reply_mr_discussion

Ответить в существующем обсуждении.

resolve_mr_discussion

Разрешить (закрыть) обсуждение.

delete_mr_discussion

Удалить обсуждение (весь тред).

Ветки

list_branches

Список веток проекта.

get_branch

Получить ветку по имени.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | branchName | string | да | Имя ветки |

get_default_branch

Получить ветку по умолчанию.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта |

create_branch

Создать ветку от существующей.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | newBranch | string | да | Имя новой ветки | | originBranch | string | да | Базовая ветка |

delete_branch

Удалить ветку.

Примечание: DELETE-эндпоинт для веток отсутствует в публичной документации GitFlic, но работает на api.gitflic.ru. Тело ответа может быть пустым — это трактуется как успех. Ветка не должна быть защищённой. (Ранее эндпоинт возвращал 405 — на текущей версии API работает.)

compare_branches

Сравнить две ветки — список изменённых файлов.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | compare | string | да | Сравниваемая ветка | | base | string | нет | Базовая ветка (по умолчанию — ветка по умолчанию) |

compare_branch_file

Изменения одного файла между двумя коммитами (построчный diff). Для всех файлов между коммитами используйте diff_commits, для файлов одного коммита — get_commit_files, для двух веток целиком — compare_branches.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | filePath | string | да | Путь к файлу в репозитории | | baseHash | string | да | Хеш базового коммита | | compareHash | string | да | Хеш сравниваемого коммита | | refresh | boolean | нет | Обойти кеш чтений |

Коммиты

list_commits

Список коммитов ветки.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | branch | string | нет | Имя ветки (по умолчанию — ветка по умолчанию) | | page | number | нет | Номер страницы (с 0) | | size | number | нет | Элементов на странице |

get_commit

Получить коммит по хешу.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | hash | string | да | Хеш коммита |

get_commit_files

Список файлов, изменённых в коммите.

diff_commits

Diff между двумя коммитами.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | sourceCommitId | string | да | Хеш исходного коммита | | targetCommitId | string | да | Хеш целевого коммита |

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | tagName | string | да | Имя тега | | message | string | нет | Сообщение (аннотированный тег) | | commitId | string | нет | Хеш коммита (указать commitId или branchName) | | branchName | string | нет | Имя ветки для тега на HEAD (указать commitId или branchName) |

Релизы

list_releases

Список релизов проекта.

get_release

Получить релиз по UUID.

get_latest_release

Получить последний релиз проекта.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта |

create_release

Создать релиз.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | title | string | да | Название релиза | | description | string | да | Описание релиза | | tagName | string | да | Имя тега | | preRelease | boolean | нет | Пометить как пре-релиз | | attachProjectArchive | boolean | нет | Прикрепить архив проекта | | projectArchiveFormat | string | нет | Формат архива: zip, tar, tar.gz, tar.xz, tar.bz2, 7z |

update_release

Обновить релиз.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | releaseUuid | string | да | UUID релиза | | title | string | да | Название релиза | | tagName | string | да | Имя тега | | description | string | нет | Описание релиза | | preRelease | boolean | нет | Пометить как пре-релиз |

delete_release

Удалить релиз.

Вебхуки

list_webhooks

Список вебхуков проекта.

get_webhook

Получить вебхук по ID.

create_webhook

Создать вебхук.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | url | string | да | URL обратного вызова | | secret | string | да | Секретный ключ | | events | string[] | да | Список событий (см. ниже) |

update_webhook

Обновить вебхук.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | webhook_id | string | да | UUID вебхука | | url | string | да | URL обратного вызова | | secret | string | да | Секретный ключ | | events | string[] | да | Список событий (см. ниже) |

delete_webhook

Удалить вебхук.

События вебхуков

COLLABORATOR_ADD, COLLABORATOR_DELETE, COLLABORATOR_UPDATE, ISSUE_CREATE, ISSUE_UPDATE, NEW_ISSUE_NOTE, TAG_CREATE, TAG_DELETE, BRANCH_CREATE, BRANCH_UPDATE, BRANCH_DELETE, MERGE_REQUEST_CREATE, MERGE_REQUEST_UPDATE, MERGE_REQUEST_CLOSE, MERGE_REQUEST_CANCEL, MERGE_REQUEST_ACCEPT, MERGE, DISCUSSION_CREATE, DISCUSSION_COMMENT_CREATE, PIPELINE_NEW, PIPELINE_SUCCESS, PIPELINE_FAIL, WEBHOOK_SEND

CI/CD

list_pipelines

Список пайплайнов проекта.

start_pipeline

Запустить пайплайн.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | refName | string | нет | Имя ветки или тега (по умолчанию — ветка по умолчанию) | | isTag | boolean | нет | true, если refName — тег | | variables | object[] | нет | Переменные: [{"key": "...", "value": "..."}] |

list_pipeline_jobs

Список задач пайплайна.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | pipeline_id | integer | да | Локальный ID пайплайна | | page | number | нет | Номер страницы (с 0) | | size | number | нет | Элементов на странице |

restart_pipeline

Перезапустить пайплайн.

cancel_pipeline

Отменить запущенный пайплайн.

get_job

Получить информацию о задаче.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | job_id | integer | да | Локальный ID задачи |

list_job_artifacts

Список артефактов задачи.

restart_job

Перезапустить задачу.

cancel_job

Отменить запущенную задачу.

list_cicd_variables

Список CI/CD переменных проекта.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта |

list_project_runners

Список CI/CD-раннеров, зарегистрированных в проекте. Возвращает имя, активность, платформу/архитектуру, IP и UUID. Эндпоинт — /project/{owner}/{project}/runners (НЕ под /cicd).

Зеркалирование

setup_push_mirror

Настроить PUSH-зеркалирование проекта на внешний Git-репозиторий (например GitHub, GitLab).

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | source | string | да | URL целевого репозитория (например https://github.com/user/repo.git) | | login | string | нет | Имя пользователя для аутентификации | | token | string | нет | Токен доступа для аутентификации |

trigger_mirror_update

Запустить синхронизацию PUSH-зеркала вручную. Проект должен быть настроен как PUSH-зеркало.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта |

Команды (Enterprise)

list_teams

Список команд, которыми владеет текущий пользователь. Команда группирует пользователей для общего доступа к проектам.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | page | number | нет | Номер страницы (с 0) | | size | number | нет | Элементов на странице |

list_shared_teams

Список команд, в которых пользователь участвует, но не владеет.

get_team

Детали команды по алиасу.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | team_alias | string | да | Алиас команды |

create_team

Создать команду. Владелец по умолчанию — текущий пользователь.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | alias | string | да | Алиас/URL-slug (уникальный) | | title | string | да | Название | | owner | string | нет | Владелец (по умолчанию текущий пользователь) | | description | string | нет | Описание |

list_team_members

Список участников команды (username, роль).

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | team_alias | string | да | Алиас команды | | page | number | нет | Номер страницы (с 0) | | size | number | нет | Элементов на странице |

invite_team_member

Пригласить пользователя в команду с ролью.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | team_alias | string | да | Алиас команды | | user_alias | string | да | Username | | role | enum | да | GUEST/REPORTER/DEVELOPER/ADMIN/OWNER |

change_team_member_role

Изменить роль участника команды.

remove_team_member

Удалить участника из команды.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | team_alias | string | да | Алиас команды | | user_alias | string | да | Username |

Компании (Enterprise)

list_companies

Список публичных компаний. Компания — организационная группировка, владеющая проектами и командами.

list_my_companies

Список компаний, которыми владеет текущий пользователь.

list_shared_companies

Список компаний, в которых пользователь участвует, но не владеет.

get_company

Детали компании по алиасу.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | company_alias | string | да | Алиас компании |

create_company

Создать компанию.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | alias | string | да | Алиас/URL-slug (уникальный) | | title | string | да | Название | | is_private | boolean | нет | Приватная (по умолчанию false) | | description | string | нет | Описание |

list_company_members

Список участников компании (username, роль).

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | company_alias | string | да | Алиас компании | | page | number | нет | Номер страницы (с 0) | | size | number | нет | Элементов на странице |

invite_company_member

Пригласить пользователя в компанию с ролью.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | company_alias | string | да | Алиас компании | | user_alias | string | да | Username | | role | enum | да | GUEST/REPORTER/DEVELOPER/ADMIN |

change_company_member_role

Изменить роль участника компании.

remove_company_member

Удалить участника из компании.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | company_alias | string | да | Алиас компании | | user_alias | string | да | Username |

Защита окружений (Enterprise)

Правила защиты окружений уровня team и company: окружение (шаблон) → кто может деплоить (ADMINS/DEVELOPER/NO_ONE).

list_team_env_protections

Список правил защиты окружений команды.

get_team_env_protection

Правило защиты окружения команды по UUID.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | team_alias | string | да | Алиас команды | | uuid | string | да | UUID правила |

create_team_env_protection

Создать правило защиты окружения команды.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | team_alias | string | да | Алиас команды | | environment_template | string | да | Имя/шаблон окружения | | allow_to_deploy | enum | да | ADMINS/DEVELOPER/NO_ONE |

edit_team_env_protection

Изменить правило защиты окружения команды.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | team_alias | string | да | Алиас команды | | uuid | string | да | UUID правила | | allow_to_deploy | enum | да | ADMINS/DEVELOPER/NO_ONE | | environment_template | string | нет | Новое имя/шаблон |

delete_team_env_protection

Удалить правило защиты окружения команды.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | team_alias | string | да | Алиас команды | | uuid | string | да | UUID правила |

list_company_env_protections

Список правил защиты окружений компании.

get_company_env_protection

Правило защиты окружения компании по UUID.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | company_alias | string | да | Алиас компании | | uuid | string | да | UUID правила |

create_company_env_protection

Создать правило защиты окружения компании.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | company_alias | string | да | Алиас компании | | environment_template | string | да | Имя/шаблон окружения | | allow_to_deploy | enum | да | ADMINS/DEVELOPER/NO_ONE |

edit_company_env_protection

Изменить правило защиты окружения компании.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | company_alias | string | да | Алиас компании | | uuid | string | да | UUID правила | | allow_to_deploy | enum | да | ADMINS/DEVELOPER/NO_ONE | | environment_template | string | нет | Новое имя/шаблон |

delete_company_env_protection

Удалить правило защиты окружения компании.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | company_alias | string | да | Алиас компании | | uuid | string | да | UUID правила |

Реестр пакетов

Управление содержимым реестра (любой формат) + загрузка/скачивание generic-артефактов. Публикация maven/npm/docker — нативными тулзами.

list_packages

Список пакетов в реестре проекта (UUID, имя, версия, тип).

list_package_versions

Список версий пакета.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | package_uuid | string | да | UUID пакета | | page | number | нет | Номер страницы (с 0) | | size | number | нет | Элементов на странице |

list_package_files

Список файлов пакета.

delete_package

Удалить пакет, версию или отдельный файл (необратимо). Только package_uuid — весь пакет; +version — версию; +file_uuid — файл.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | package_uuid | string | да | UUID пакета | | version | string | нет | Версия (для удаления версии) | | file_uuid | string | нет | UUID файла (требует version) |

upload_generic_artifact

Загрузить локальный файл в generic-реестр под package/version/fileName (сырые байты).

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | package_name | string | да | Имя пакета | | version | string | да | Версия | | file_name | string | да | Имя файла в реестре | | local_path | string | да | Путь к локальному файлу |

download_generic_artifact

Скачать файл из generic-реестра в локальный путь.

| Параметр | Тип | Обяз. | Описание | |---|---|---|---| | owner | string | да | Алиас владельца | | project | string | да | Алиас проекта | | package_name | string | да | Имя пакета | | version | string | да | Версия | | file_name | string | да | Имя файла в реестре | | output_path | string | да | Локальный путь для записи |

Кеширование

Чтобы не дёргать GitFlic API повторно за теми же данными, ответы GET-чтений кешируются в памяти процесса.

TTL задаётся через GITFLIC_CACHE_TTL_MS (по умолчанию 60000 мс). Значение 0 полностью отключает кеш.
Инвалидация при записи: любая операция записи (POST/PUT/DELETE) к проекту /{owner}/{project}/… чистит кеш-записи этого проекта. Поэтому после своего же update_issue/create_*/delete_* следующее чтение сразу отдаёт свежее, без ручного сброса. Чужие проекты в кеше не затрагиваются.
Принудительное обновление: все read-инструменты принимают опциональный refresh: true — он обходит кеш и перечитывает данные с сервера (актуально, когда данные мог изменить кто-то другой через веб-интерфейс в пределах TTL).

Кешируются только чтения; записи никогда не кешируются.

Картинки в текстовых полях

GitFlic хранит и отображает картинки, встроенные прямо в markdown текстовых полей как data-URI (![alt](data:image/png;base64,…)). MCP-сервер инкапсулирует это с двух сторон, чтобы не раздувать контекст агента сырым base64.

Запись. Инструменты создания и обновления принимают опциональный imagePaths (string[]) — пути к локальным файлам-картинкам. Сервер сам читает файл, кодирует в base64 data-URI и дописывает в конец описания/комментария. Агент передаёт путь, а не вставляет base64 вручную.

Поддерживают imagePaths: create_issue, update_issue, add_issue_comment, edit_issue_comment, create_merge_request, update_merge_request, create_mr_discussion, reply_mr_discussion.

Чтение. Инструменты get_issue, get_merge_request, find_mr_by_commit, list_issue_comments, list_mr_discussions, get_mr_discussion (а также ответы create/update) вырезают base64 из текста, заменяя коротким плейсхолдером (![alt](image#1 · image/png · 12 КБ)), и возвращают сами картинки отдельными бинарными MCP image-блоками. Так агент видит картинку, а контекст не забивается base64.

Нюансы:

Для update_merge_request картинки дописываются к переданному description — передайте текущее описание (из get_merge_request), чтобы не затереть его.
Картинки крупнее ~750 КБ не инлайнятся (лимит вывода MCP-клиента, по умолчанию ~25000 токенов) — остаётся плейсхолдер с пометкой размера, смотреть в веб-интерфейсе GitFlic.
GitFlic отдаёт описания issue/MR как markdown, а комментарии — как HTML (<img src="data:…">); сервер обрабатывает обе формы.

Известные ограничения

CI/CD требует настройки. Для работы инструментов start_pipeline, restart_pipeline, cancel_pipeline и операций с задачами необходим файл gitflic-ci.yaml в репозитории и подключённый runner.
link_issue_file / unlink_issue_file не полностью протестированы. Требуют uploadFileUuid от предварительно загруженного файла. Загрузка файлов через MCP-сервер пока не реализована.

Лицензия

Apache License 2.0

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

gitflic-mcp

Зачем

Установка

Требования

Через npx (рекомендуется)

Сборка из исходников

Настройка MCP-клиента

Инструменты

Пользователи

get_me

get_user

list_user_projects

Проекты

list_projects

get_project

search_projects

list_shared_projects

create_project

fork_project

update_project

delete_project

list_project_members

invite_project_member

change_member_role

remove_project_member

invite_project_team

change_team_role

remove_project_team

Issue

list_issues

get_issue

create_issue

delete_issue

list_issue_files

link_issue_file

unlink_issue_file

update_issue

Связи issue

list_issue_relations

create_issue_relation

delete_issue_relation

Комментарии к issue

list_issue_comments

add_issue_comment

edit_issue_comment

delete_issue_comment

Файлы репозитория

get_file_content

list_files

list_files_recursive

Merge Request

list_merge_requests

get_merge_request

find_mr_by_commit

create_merge_request

update_merge_request

approve_merge_request

merge_merge_request

close_merge_request

cancel_merge_request

Обсуждения MR

list_mr_discussions

get_mr_discussion

create_mr_discussion

reply_mr_discussion

resolve_mr_discussion

delete_mr_discussion

Ветки

list_branches

get_branch

get_default_branch

create_branch

delete_branch

compare_branches