Sign inSign up

rd2w/gerrit-mcp

By rd2w

•Updated about 1 month ago

Gerrit MCP Server

Image
Developer tools
0

1.1K

rd2w/gerrit-mcp repository overview

⁠Gerrit MCP Server

MCP (Model Context Protocol) server enabling AI assistants (Claude, Codex, etc.) to directly interact with Gerrit for code review tasks. Designed for AOSP-scale codebases and corporate deployments.

MCP (Model Context Protocol) сервер, который позволяет AI-ассистентам (Claude, Codex и др.) напрямую взаимодействовать с Gerrit для задач code review. Спроектирован для AOSP-масштабных кодовых баз и корпоративного деплоя.


⁠Capabilities | Возможности
ENRU
Search & readChanges, reviews, diffs, comments, bug referencesПоиск и чтение изменений, ревью, диффов, комментариев, баг-референсов
Manage changesCreate, cherry-pick, revert, abandon, submitСоздание, cherry-pick, revert, abandon, submit
Code reviewPost drafts, review comments, vote on labelsПубликация черновиков и ревью-комментариев, голосование
FilteringBy date, project, author, commit message substringФильтрация по датам, проектам, авторам, подстрокам в коммитах

32 MCP tools — full Gerrit REST API coverage.
32 MCP-инструментов — полное покрытие Gerrit REST API.


⁠Quick Start | Быстрый старт
docker pull rd2w/gerrit-mcp:latest

docker run -d -p 8080:8080 \
  -v ./config:/config:ro \
  --env-file ./config/.env \
  rd2w/gerrit-mcp:latest

Config example — config/config.example.toml⁠. Пример конфига — config/config.example.toml⁠.

Two transport modes (can run both simultaneously): Два режима транспорта (можно запустить оба одновременно):

  • stdio — for docker exec and local deployment / для docker exec и локального деплоя
  • Streamable HTTP — for remote AI clients via HTTP API / для удалённых AI-клиентов через HTTP API

⁠Authentication | Аутентификация

Bearer token, HTTP Basic Auth, or GitCookies file parsing. Credentials are loaded from environment variables (never from the config file). Custom corporate CA certificates supported via GERRIT_CA_CERT.

Bearer token, HTTP Basic Auth или парсинг GitCookies. Креды загружаются из переменных окружения (никогда из конфиг-файла). Поддержка самоподписных корпоративных сертификатов через GERRIT_CA_CERT.


⁠Production Features | Production-возможности
FeatureDetail
Rate limitingGCRA token bucket, configurable RPS and burst
CachingIn-memory DashMap-based, TTL + LRU eviction
TLSrustls with custom CA certificate support
Health endpoints/healthz (liveness), /readyz (readiness), /metrics (Prometheus)
DNS Rebind ProtectionHost header validation via allowed_hosts
Air-gapped deploymentSelf-contained ~23 MB image (UPX-compressed), docker save → docker load without internet
Multi-archlinux/amd64, linux/arm64

⁠Docker Compose
services:
  gerrit-mcp:
    image: rd2w/gerrit-mcp:latest
    ports:
      - "8080:8080"
    volumes:
      - ./config:/config:ro
    env_file:
      - ./config/.env
    restart: unless-stopped

Tag summary

Content type

Image

Digest

sha256:fcc4aac46…

Size

8.1 MB

Last updated

about 1 month ago

docker pull rd2w/gerrit-mcp