MCP-сервер Gitee

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

Возможности

• Взаимодействие с репозиториями, задачами, запросами на слияние и уведомлениями Gitee

• Настраиваемый базовый URL API для поддержки различных экземпляров Gitee

• Флаги командной строки для простой настройки

• Поддержка операций с личными, организационными и корпоративными аккаунтами

• Динамическое включение/отключение наборов инструментов

1. Получение задач репозитория

2. Реализация кода и создание запроса на слияние на основе деталей задачи

3. Комментирование и закрытие задачи

Related MCP server: Gitea MCP Tool

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

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

• Go 1.23.0 или выше

• Аккаунт Gitee с токеном доступа, получить здесь

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

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:

mcp-gitee --version

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

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

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

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

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

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

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

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

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

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

• Имена инструментов чувствительны к регистру

Лицензия

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

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

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

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

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

1. Сделайте форк репозитория.

2. Создайте новую ветку для вашей функции или исправления ошибки.

3. Внесите изменения и убедитесь, что код хорошо задокументирован.

4. Отправьте запрос на слияние (pull request) с четким описанием ваших изменений.

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