Gitea MCP Server

Что умеет сервер

Gitea MCP Server подключает ваш экземпляр Gitea к MCP-клиентам: репозитории, issues и pull request можно просматривать и вести из чата. Проект выпускает организация gitea, он лежит на gitea.com, а не на GitHub. Сервер написан на Go и распространяется бинарным файлом, Docker-образом или собирается из исходников.

Инструменты покрывают почти всю платформу: поиск пользователей, репозиториев и задач, чтение и запись файлов одним коммитом, ветки и теги, коммиты и сравнение ссылок, issues, метки и вехи, pull request вместе с ревью и слиянием, релизы, вики, учёт времени, проекты, пакеты и Gitea Actions (запуски, задания, логи, секреты и переменные). Многие инструменты объединены: один инструмент выполняет несколько операций через параметр method.

Когда использовать

Сервер нужен, если ваш код хранится в Gitea (на gitea.com или на собственном сервере) и вы хотите работать с ним из AI-клиента: разобрать очередь задач, подготовить pull request, найти причину упавшего запуска Actions, оформить релиз.

Запустить сервер можно по-разному: локально по stdio, с передачей токена в переменной окружения, или как HTTP-сервис. HTTP-режим всегда работает без сессий, и токен Gitea передаётся в заголовке Authorization в каждом запросе.

Ограничения и безопасность

Для доступа нужны адрес Gitea и персональный токен доступа (флаги или переменные окружения). Агент действует с правами этого токена, поэтому выдайте только нужные. Инструменты с записью скрываются в режиме только для чтения (-r или GITEA_READONLY), а набор можно сузить по областям (--scope) или по именам инструментов (--tools). Среди инструментов есть удаляющие: версии пакета (в README помечено как необратимое), релиза, ветки, тега и файла.

Клиентам, которым нельзя выдать токен (Claude.ai в вебе и на мобильных), нужен поток OAuth 2.1: сервер запускают с флагом -oauth, а в Gitea один раз регистрируют приложение OAuth2. Сервер и Gitea при этом должны быть доступны по HTTPS из сети клиента. Размер страницы в списках ограничен настройкой MAX_RESPONSE_ITEMS самой Gitea (по умолчанию 50). Для сборки из исходников в README указан Go 1.27 или новее.

Установка

Скачайте бинарный файл со страницы релизов и положите его в PATH, используйте образ docker.gitea.com/gitea-mcp-server или соберите из исходников (нужен Go 1.27 или новее):

git clone https://gitea.com/gitea/gitea-mcp.git
cd gitea-mcp
make install

Адрес Gitea и токен передаются флагами командной строки или переменными окружения (флаги важнее). Полный список выводит gitea-mcp --help.

Claude Code

Сервер запускается через go run, поэтому нужен установленный Go:

claude mcp add --transport stdio --scope user gitea \
  --env GITEA_ACCESS_TOKEN=token \
  --env GITEA_HOST=https://gitea.com \
  -- go run gitea.com/gitea/gitea-mcp@latest -t stdio

VS Code

Добавьте блок в пользовательские настройки (JSON), которые открывает Ctrl + Shift + P и Preferences: Open User Settings (JSON). В .vscode/mcp.json рабочей области тот же блок работает без ключа mcp.

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "gitea_token",
        "description": "Gitea Personal Access Token",
        "password": true
      }
    ],
    "servers": {
      "gitea-mcp": {
        "command": "docker",
        "args": ["run", "-i", "--rm", "-e", "GITEA_ACCESS_TOKEN", "docker.gitea.com/gitea-mcp-server"],
        "env": {
          "GITEA_ACCESS_TOKEN": "${input:gitea_token}"
        }
      }
    }
  }
}

Cursor и другие клиенты

Клиенты вроде Cursor принимают команду stdio:

{
  "mcpServers": {
    "gitea": {
      "command": "gitea-mcp",
      "args": ["-t", "stdio", "--host", "https://gitea.com"],
      "env": {
        "GITEA_ACCESS_TOKEN": "<your personal access token>"
      }
    }
  }
}

или адрес HTTP-сервера, запущенного командой gitea-mcp -t http --port 8080:

{
  "mcpServers": {
    "gitea": {
      "url": "http://localhost:8080/mcp",
      "headers": {
        "Authorization": "Bearer <your personal access token>"
      }
    }
  }
}

OpenCode

Добавьте в объект mcp верхнего уровня конфигурации OpenCode:

    "gitea-mcp": {
      "enabled": true,
      "type": "local",
      "command": [
        "gitea-mcp",
        "-t", "stdio",
        "-H", "https://gitea.com",
        "-T", "<your personal access token>"
      ]
    }

Фильтры инструментов

gitea-mcp -S issue,pull_request
gitea-mcp --scope repository,branch --tools get_me

После настройки попробуйте в чате запрос list all my repositories.