Gitea MCP: задачи, пулл-реквесты и релизы Gitea из Claude и Cursor

werebear73/gitea-mcp· Проверено 12.11.2026· 2на GitHub

Подключает агента к вашему Gitea по личному токену: задачи, пулл-реквесты, ветки, файлы и релизы. Второй сервер создаёт репозитории и заливает в них проект целиком.

2 реализации:

21 инструмент для задач, пулл-реквестов, файлов и релизов; заявлена работа с Forgejo и Codeberg.

Как подключить

Что сделать до подключения

Python 3.11 или новее и uv

GITEA_URL

адрес вашего экземпляра, например https://gitea.example.com

GITEA_TOKEN

в Gitea: Settings → Applications → Generate New Token, права read:repository, write:issue, read:user; для релизов добавьте write:repository

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'GITEA_URL=<адрес вашего Gitea>' --env 'GITEA_TOKEN=<ваш токен>' --transport stdio gitea \
  -- uvx gitea-mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.gitea]
command = "uvx"
args = ["gitea-mcp"]

[mcp_servers.gitea.env]
GITEA_URL = "<адрес вашего Gitea>"
GITEA_TOKEN = "<ваш токен>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "gitea": {
      "command": "uvx",
      "args": ["gitea-mcp"],
      "env": {
        "GITEA_URL": "<адрес вашего Gitea>",
        "GITEA_TOKEN": "<ваш токен>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "gitea": {
      "type": "stdio",
      "command": "uvx",
      "args": ["gitea-mcp"],
      "env": {
        "GITEA_URL": "<адрес вашего Gitea>",
        "GITEA_TOKEN": "<ваш токен>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "gitea": {
      "command": "uvx",
      "args": ["gitea-mcp"],
      "env": {
        "GITEA_URL": "<адрес вашего Gitea>",
        "GITEA_TOKEN": "<ваш токен>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "gitea": {
      "command": "uvx",
      "args": ["gitea-mcp"],
      "env": {
        "GITEA_URL": "<адрес вашего Gitea>",
        "GITEA_TOKEN": "<ваш токен>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "gitea": {
        "type": "local",
        "command": ["uvx", "gitea-mcp"],
        "environment": {
          "GITEA_URL": "<адрес вашего Gitea>",
          "GITEA_TOKEN": "<ваш токен>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "gitea": {
      "command": "uvx",
      "args": ["gitea-mcp"],
      "env": {
        "GITEA_URL": "<адрес вашего Gitea>",
        "GITEA_TOKEN": "<ваш токен>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "gitea": {
      "command": "uvx",
      "args": ["gitea-mcp"],
      "env": {
        "GITEA_URL": "<адрес вашего Gitea>",
        "GITEA_TOKEN": "<ваш токен>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

create_issueсоздаёт задачу

list_issuesперечисляет задачи

get_issueоткрывает задачу

update_issueправит задачу

add_commentкомментирует задачу

list_reposперечисляет репозитории

list_labelsперечисляет метки

list_milestonesперечисляет вехи

list_branchesперечисляет ветки

list_pull_requestsперечисляет пулл-реквесты

get_pull_requestоткрывает пулл-реквест

add_comment_on_prкомментирует пулл-реквест

create_prоткрывает пулл-реквест

merge_prвливает пулл-реквест

read_fileчитает файл

commit_changesкоммитит изменения

create_branchсоздаёт ветку

list_releasesперечисляет релизы

create_releaseвыпускает релиз

get_server_infoсообщает данные сервера

Показано 20 из 21.

4 инструмента для заливки кода: создать репозиторий, загрузить файлы, синхронизировать папку проекта; несколько экземпляров Gitea в одном конфиге.

Как подключить

Что сделать до подключения

Node.js 18 или новее

Клонировать репозиторий, выполнить npm install и npm run build

GITEA_INSTANCES

JSON со списком экземпляров: id, name, baseUrl и token; токен — Settings → Applications → Personal Access Tokens с правами repo, write:repository, read:user

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'GITEA_INSTANCES=<JSON-список экземпляров: id, name, baseUrl, token>' --transport stdio gitea-mcp \
  -- node /path/to/gitea-mcp/build/index.js

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.gitea-mcp]
command = "node"
args = ["/path/to/gitea-mcp/build/index.js"]

[mcp_servers.gitea-mcp.env]
GITEA_INSTANCES = "<JSON-список экземпляров: id, name, baseUrl, token>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "gitea-mcp": {
      "command": "node",
      "args": ["/path/to/gitea-mcp/build/index.js"],
      "env": {
        "GITEA_INSTANCES": "<JSON-список экземпляров: id, name, baseUrl, token>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "gitea-mcp": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/gitea-mcp/build/index.js"],
      "env": {
        "GITEA_INSTANCES": "<JSON-список экземпляров: id, name, baseUrl, token>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "gitea-mcp": {
      "command": "node",
      "args": ["/path/to/gitea-mcp/build/index.js"],
      "env": {
        "GITEA_INSTANCES": "<JSON-список экземпляров: id, name, baseUrl, token>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "gitea-mcp": {
      "command": "node",
      "args": ["/path/to/gitea-mcp/build/index.js"],
      "env": {
        "GITEA_INSTANCES": "<JSON-список экземпляров: id, name, baseUrl, token>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "gitea-mcp": {
        "type": "local",
        "command": ["node", "/path/to/gitea-mcp/build/index.js"],
        "environment": {
          "GITEA_INSTANCES": "<JSON-список экземпляров: id, name, baseUrl, token>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "gitea-mcp": {
      "command": "node",
      "args": ["/path/to/gitea-mcp/build/index.js"],
      "env": {
        "GITEA_INSTANCES": "<JSON-список экземпляров: id, name, baseUrl, token>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "gitea-mcp": {
      "command": "node",
      "args": ["/path/to/gitea-mcp/build/index.js"],
      "env": {
        "GITEA_INSTANCES": "<JSON-список экземпляров: id, name, baseUrl, token>"
      }
    }
  }
}

Инструменты сервера

create_repositoryсоздаёт репозиторий

upload_filesзагружает файлы с папками

sync_projectзаливает проект в новый репозиторий

sync_updateменяет, добавляет и удаляет файлы

Что попросить агента

«Заведи в <владелец>/<репозиторий> задачу про <что нашли> с меткой <метка>»Агент найдёт метку через list_labels и создаст задачу create_issue

«Покажи открытые задачи в <владелец>/<репозиторий> и оставь комментарии к тем, что уже сделаны»Агент вызовет list_issues, get_issue и add_comment

«Создай ветку <ветка>, закоммить правку в <файл> и открой пулл-реквест»Агент вызовет create_branch, commit_changes и create_pr

«Выпусти релиз <версия> в <владелец>/<репозиторий>»Агент сверится со списком list_releases и вызовет create_release

«Создай приватный репозиторий <имя> и залей туда этот проект»MushroomFleet вызовет create_repository, затем sync_project, сначала с dryRun для проверки списка файлов

Для каких задач

Завести задачу по итогам ревью или аудита, не выходя из чата

Разобрать открытые задачи репозитория и прокомментировать их

Создать ветку, закоммитить правку и открыть пулл-реквест

Выпустить релиз в конце рабочей сессии

Создать репозиторий и залить в него проект с учётом .gitignore

Ограничения

У werebear73/gitea-mcp 2 звезды и последнее обновление в мае 2026 года; у MushroomFleet 17 звёзд, обновлялся в апреле 2026 года

MushroomFleet работает только с репозиториями и файлами, задач и пулл-реквестов в нём нет; sync_project создаёт только новые файлы, существующие меняет sync_update

В режиме HTTP сервер werebear73 ходит в Gitea с одним токеном из своего окружения: любой, кто достучится до адреса, действует от имени этого пользователя

Если не работает

MushroomFleet: ошибка Authentication Failed

Проверьте токен и его права, не истёк ли он, и адрес baseUrl в GITEA_INSTANCES.

MushroomFleet: запросы упираются в лимит

Уменьшите размер пачки при загрузке файлов или поменяйте rateLimit в настройках экземпляра; по умолчанию 100 запросов в минуту.

MushroomFleet: загрузка файлов падает

Проверьте содержимое файлов и пути без запрещённых символов, а ещё что репозиторий существует и у токена есть права на запись.

MushroomFleet: сборка на Windows падает на chmod

Команды chmod в Windows нет; в package.json сборка уже заменена на совместимую с Windows, обновите репозиторий.

MushroomFleet: ошибка настройки логов

Поставьте пакет pino-pretty: npm install --save-dev pino-pretty.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
gitea-mcp	Waretech Services	2	локально	токен	21	29 мая 2026
Gitea MCP Server	MushroomFleet	17	локально	токен	4	7 апреля 2026

Частые вопросы

Подойдёт ли сервер для Forgejo и Codeberg?

У werebear73/gitea-mcp основная цель — свой Gitea, а с Forgejo и Codeberg он должен работать, у них тот же API. Задайте в GITEA_URL адрес нужного экземпляра.

Какие права дать токену?

Для werebear73: read:repository, write:issue и read:user, для релизов ещё write:repository. Для MushroomFleet: repo, write:repository и read:user.

Как проверить, что сервер видит мой Gitea?

Выполните gitea-mcp doctor: команда берёт GITEA_URL и GITEA_TOKEN из окружения, запрашивает /api/v1/user и выводит имя пользователя. Код выхода 0 значит, что всё готово.

Можно ли подключить несколько экземпляров Gitea?

Да, у MushroomFleet: перечислите их в GITEA_INSTANCES, каждому свой id, адрес и токен. В вызове инструмента экземпляр выбирается параметром instanceId.

Как подключить Gitea MCP к Claude Desktop?

Выполните gitea-mcp init: команда спросит адрес Gitea и токен, проверит связь и сама допишет claude_desktop_config.json, затем перезапустите Claude Desktop. Для других клиентов откройте нужную вкладку в блоке «Как подключить».

Можно ли держать один Gitea MCP на сервере для нескольких клиентов?

Да: gitea-mcp serve --transport http --host 0.0.0.0 --port 8000 --path /mcp. Клиенты подключаются к адресу вида https://<ваш хост>/mcp; закройте его фаерволом, VPN или авторизацией на прокси.

Работает ли сервер из России?

Серверы работают на вашем компьютере и ходят в API вашего экземпляра Gitea по личному токену, зарубежные аккаунты не нужны.

Gitea MCP: задачи, пулл-реквесты и релизы Gitea из Claude и Cursor

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы