Sign inSign up

rd2w/opengrok-mcp

By rd2w

•Updated about 1 month ago

OpenGrok MCP Server

Image
Developer tools
0

1.7K

rd2w/opengrok-mcp repository overview

⁠OpenGrok MCP Server

MCP (Model Context Protocol) server for OpenGrok code search. Designed for AOSP 15-scale codebases and corporate deployments.

MCP (Model Context Protocol) сервер для поиска по коду OpenGrok. Спроектирован для кодовых баз масштаба AOSP 15 и корпоративного деплоя.

⁠Capabilities | Возможности
ENRU
Full-text searchCode, definitions, references, file paths, historyПолнотекстовый поиск, определения, ссылки, пути к файлам, история
File inspectionContent, definitions in file, annotation (blame), genre detectionСодержимое файлов, определения в файле, аннотация (blame), определение типа
NavigationDirectory listing, projects, groups, repository propertiesСписок директорий, проекты, группы, свойства репозиториев
SuggestionsAutocomplete for all search fieldsАвтодополнение для всех поисковых полей

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

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

docker run -d -p 8080:8080 \
  -v ./config:/config:ro \
  --env-file ./config/.env \
  rd2w/opengrok-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 (MCP 2026-07-28 + 2025-11-25 fallback) / для удалённых AI-клиентов через HTTP API
⁠Authentication | Аутентификация

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

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

⁠Production Features | Production-возможности
FeatureDetail
Rate limitingGCRA token bucket, configurable RPS and burst
CachingIn-memory LRU cache (Mutex<LruCache>), TTL + LRU eviction
HTML strippingAutomatic cleanup of OpenGrok HTML responses
Paginationhas_more hints for large result sets
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:
  opengrok-mcp:
    image: rd2w/opengrok-mcp:latest
    ports:
      - "8080:8080"
    volumes:
      - ./config:/config:ro
    env_file:
      - ./config/.env
    restart: unless-stopped
⁠Links | Ссылки

Tag summary

Content type

Image

Digest

sha256:137a5793b…

Size

7.8 MB

Last updated

about 1 month ago

docker pull rd2w/opengrok-mcp