MCP-сервер Gitee

MCP-сервер Gitee — это реализация сервера протокола контекста модели (MCP) для Gitee. Он предоставляет набор инструментов для взаимодействия с API Gitee, позволяя ИИ-ассистентам управлять репозиториями, задачами, запросами на слияние и многим другим.

Установить MCP-сервер

Возможности

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

Получение задач репозитория
Реализация кода и создание запроса на слияние на основе деталей задачи
Комментирование и закрытие задачи

Related MCP server: PyGithub MCP Server

Установка (этот шаг можно пропустить при запуске через npx)

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

Go 1.23.0 или выше
Аккаунт Gitee с токеном доступа, получить здесь

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

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

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

Соберите проект:
```
make build
```
Переместите ./bin/mcp-gitee в PATH

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

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

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

Проверка версии mcp-gitee:

mcp-gitee --version

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

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

Подключение к официальному удаленному серверу mcp-gitee (установка не требуется)

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

{
  "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>"
      }
    }
  }
}

Исполняемый файл

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

Опции командной строки

--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: Список инструментов через запятую для отключения

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

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

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

Примечание:

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

Лицензия

Этот проект лицензирован по лицензии 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	Список запросов на слияние в репозитории
merge_pull	Pull Request	Слияние запроса на слияние
create_pull	Pull Request	Создать запрос на слияние
update_pull	Pull Request	Обновить запрос на слияние
get_pull_detail	Pull Request	Получить детали запроса на слияние
get_diff_files	Pull Request	Получить файлы с различиями (diff) запроса на слияние
manage_pull_review	Pull Request	Управление проверкой запроса на слияние (одобрить или отменить)
create_comment	Комментарий	Создать комментарий к задаче или запросу на слияние
list_comments	Комментарий	Список всех комментариев к задаче или запросу на слияние
create_issue	Задача	Создать задачу
update_issue	Задача	Обновить задачу
get_repo_issue_detail	Задача	Получить детали задачи репозитория
list_repo_issues	Задача	Список задач репозитория
get_user_info	Пользователь	Получить информацию о текущем авторизованном пользователе
search_users	Пользователь	Поиск пользователей
list_user_notifications	Уведомление	Список уведомлений пользователя

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

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

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

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

Gitee