Gitee

Gitee MCP-сервер

Gitee MCP-сервер — это реализация сервера Model Context Protocol (MCP) для Gitee. Он предоставляет набор инструментов для взаимодействия с API Gitee, позволяя AI-ассистентам управлять репозиториями, задачами, pull request'ами и многоим другим.

Возможности

• Взаимодействие с репозиториями, задачами, pull request'ами и уведомлениями Gitee
• Настраиваемый базовый URL API для поддержки различных экземпляров Gitee
• Флаги командной строки для простой настройки
• Поддержка операций для личных, организационных и корпоративных аккаунтов
• Динамическое включение/отключение наборов инструментов

Практический сценарий: получить задачу из репозитория, реализовать и создать pull request

1. Получить задачи репозитория
2. Реализовать код и создать pull request на основе деталей задачи
3. Оставить комментарий и закрыть задачу

Установка

Удалённый MCP-сервер не требует установки и работает сразу. Чтобы запустить mcp-gitee локально (stdio), выберите один из вариантов ниже.

Удалённый MCP-сервер (рекомендуется)

Добавьте следующее в секцию mcpServers конфигурации вашего хоста, заменив <your personal access token> на токен из этого источника:

{
  "mcpServers": {
    "gitee": {
      "url": "https://api.gitee.com/mcp",
      "headers": {
        "Authorization": "Bearer <your personal access token>"
      }
    }
  }
}

Для путей и форматов конфигурационных файлов конкретных клиентов (Claude Code, Codex, Cursor, Trae, Cline, Continue, opencode) следуйте руководствам, указанным в разделе «Конфигурация MCP-хостов» ниже.

Локально (stdio)

Загрузка готовых бинарных файлов

Загрузите архив для вашей платформы (linux-amd64 / linux-arm / darwin-amd64 / darwin-arm64 / windows-amd64) из Releases, распакуйте его и поместите mcp-gitee в PATH (в Windows исполняемый файл называется mcp-gitee.exe).

Использование npx

Установка не требуется; готовый бинарный файл для вашей платформы загружается автоматически при запуске:

{
  "mcpServers": {
    "gitee": {
      "command": "npx",
      "args": [
        "-y",
        "@gitee/mcp-gitee@latest"
      ],
      "env": {
        "GITEE_API_BASE": "https://gitee.com/api/v5",
        "GITEE_ACCESS_TOKEN": "<your personal access token>"
      }
    }
  }
}

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

Требуется Go 1.23.0 или выше.

1. Клонируйте репозиторий:

   git clone https://gitee.com/oschina/mcp-gitee.git
   cd mcp-gitee
   

2. Соберите проект:

   make build
   

   Переместите ./bin/mcp-gitee в переменную окружения PATH

Использование go install

go install gitee.com/oschina/mcp-gitee@latest

Использование установленного исполняемого файла

Когда mcp-gitee доступен в PATH (через Releases, сборку из исходного кода или go install):

{
  "mcpServers": {
    "gitee": {
      "command": "mcp-gitee",
      "env": {
        "GITEE_API_BASE": "https://gitee.com/api/v5",
        "GITEE_ACCESS_TOKEN": "<your personal access token>"
      }
    }
  }
}

Windows: исполняемый файл должен содержать суффикс .exe, а путь в command должен использовать прямые слэши / (Windows их принимает, и это позволяет избежать ошибок экранирования обратной косой черты в JSON):

{
  "mcpServers": {
    "gitee": {
      "command": "C:/Users/<you>/bin/mcp-gitee.exe",
      "env": {
        "GITEE_ACCESS_TOKEN": "<your personal access token>"
      }
    }
  }
}

Конфигурация MCP-хостов

Примеры конфигурации: Нажмите, чтобы просмотреть больше конфигураций приложений

• Claude Code
• Codex
• Cursor
• Trae
• Cline
• Continue
• opencode

Параметры командной строки

• --token: токен доступа Gitee
• --api-base: базовый URL API Gitee (по умолчанию: https://gitee.com/api/v5)
• --version: показать информацию о версии
• --transport: тип транспорта (stdio, sse или http, по умолчанию: stdio)
• --address: хост и порт для запуска сервера (по умолчанию: localhost:8000)
• --enabled-toolsets: список инструментов для включения через запятую (если указано, будут включены только эти инструменты)
• --disabled-toolsets: список инструментов для отключения через запятую

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

Вы также можете настроить сервер с помощью переменных окружения:

• GITEE_ACCESS_TOKEN: токен доступа Gitee
• GITEE_API_BASE: базовый URL API Gitee
• ENABLED_TOOLSETS: список инструментов для включения через запятую
• DISABLED_TOOLSETS: список инструментов для отключения через запятую

Управление наборами инструментов

Управление наборами инструментов поддерживает два режима:

1. Включение указанных инструментов (режим белого списка):

   • Используйте параметр --enabled-toolsets или переменную окружения ENABLED_TOOLSETS
   • После указания будут включены только перечисленные инструменты, остальные будут отключены
   • Пример: --enabled-toolsets="list_user_repos,get_file_content"

2. Отключение указанных инструментов (режим чёрного списка):

   • Используйте параметр --disabled-toolsets или переменную окружения DISABLED_TOOLSETS
   • После указания перечисленные инструменты будут отключены, остальные будут включены
   • Пример: --disabled-toolsets="list_user_repos,get_file_content"

Примечание:

• Если указаны и enabled-toolsets, и disabled-toolsets, приоритет имеет enabled-toolsets
• Имена инструментов чувствительны к регистру

Фильтрация инструментов для каждого запроса (HTTP-заголовки)

При использовании удалённого MCP-сервера (транспорт HTTP/SSE) вы можете динамически фильтровать доступные инструменты для каждого запроса через HTTP-заголовки. Это полезно для клиентов, которым нужен точный контроль над доступом к инструментам без перезапуска сервера.

1. Включение указанных инструментов через заголовок (белый список):

   • Используйте заголовок X-MCP-Enabled-Tools
   • Для этого запроса будут включены только перечисленные инструменты
   • Пример: X-MCP-Enabled-Tools: list_user_repos,get_file_content

2. Отключение указанных инструментов через заголовок (чёрный список):

   • Используйте заголовок X-MCP-Disabled-Tools
   • Перечисленные инструменты будут отключены для этого запроса
   • Пример: X-MCP-Disabled-Tools: create_repo,delete_repo

Правила приоритета:

• Если в одном запросе присутствуют и X-MCP-Enabled-Tools, и X-MCP-Disabled-Tools, приоритет имеет белый список (X-MCP-Enabled-Tools)
• Имена инструментов чувствительны к регистру

Пример конфигурации для Cursor/Claude:

{
  "mcpServers": {
    "gitee": {
      "url": "https://api.gitee.com/mcp",
      "headers": {
        "Authorization": "Bearer <your personal access token>",
        "X-MCP-Enabled-Tools": "list_user_repos,get_file_content,list_repo_issues"
      }
    }
  }
}

Лицензия

Этот проект лицензирован по лицензии MIT. Подробнее см. в файле LICENSE.

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

Сервер предоставляет различные инструменты для взаимодействия с Gitee:

Инструмент	Категория	Описание
list_user_repos	Репозиторий	Список авторизованных репозиториев пользователя
get_file_content	Репозиторий	Получить содержимое файла в репозитории
create_repo	Репозиторий	Создать репозиторий (пользовательский, организационный или корпоративный)
fork_repository	Репозиторий	Создать форк репозитория
create_release	Репозиторий	Создать релиз для репозитория
list_releases	Репозиторий	Список релизов репозитория
search_open_source_repositories	Репозиторий	Поиск открытых исходных репозиториев на Gitee
search_files_by_content	Репозиторий	Поиск файлов по содержимому в репозитории
compare_branches_tags	Репозиторий	Сравнение двух веток, тегов или коммитов в репозитории
list_repo_pulls	Pull Request	Список pull request'ов в репозитории
merge_pull	Pull Request	Слияние pull request'а
create_pull	Pull Request	Создание pull request'а
update_pull	Pull Request	Обновление pull request'а
get_pull_detail	Pull Request	Получение деталей pull request'а
get_diff_files	Pull Request	Получение файлов изменений pull request'а
manage_pull_review	Pull Request	Управление рецензией pull request'а (одобрение или отмена)
create_comment	Комментарий	Создание комментария к задаче или pull request'у
list_comments	Комментарий	Список всех комментариев для задачи или pull request'а
create_issue	Задача	Создание задачи
update_issue	Задача	Обновление задачи
get_repo_issue_detail	Задача	Получение деталей задачи репозитория
list_repo_issues	Задача	Список задач репозитория
get_user_info	Пользователь	Получение информации о текущем аутентифицированном пользователе
search_users	Пользователь	Поиск пользователей
list_user_notifications	Уведомление	Список уведомлений пользователя

Вклад в проект

Мы приветствуем вклад от сообщества открытого исходного кода! Если вы хотите внести свой вклад в этот проект, пожалуйста, следуйте этим рекомендациям:

1. Создайте форк репозитория.
2. Создайте новую ветку для вашей функции или исправления ошибки.
3. Внесите изменения и убедитесь, что код хорошо документирован.
4. Отправьте pull request с понятным описанием ваших изменений.

Для получения дополнительной информации обратитесь к файлу CONTRIBUTING.