OpenGrok MCP Server

MCP

by IcyHot09 · v9.0.1

MCP server bridging OpenGrok search engine with AI for instant context across massive codebases.

mcplocal

MCP configuration

stdio

Command

npx -y opengrok-mcp-server@9.0.1

Environment

  • OPENGROK_BASE_URLrequired

    OpenGrok server base URL (e.g. https://opengrok.example.com/source/)

  • OPENGROK_USERNAMErequired

    OpenGrok authentication username

  • OPENGROK_PASSWORDsecret

    OpenGrok authentication password. Prefer storing via OS keychain using 'npx opengrok-mcp-server setup'.

  • OPENGROK_VERIFY_SSL

    Verify TLS certificates. Set to false for self-signed or internal CA certs.

  • OPENGROK_CODE_MODE

    Enable Code Mode: 5-tool sandbox interface with env.opengrok.* JavaScript API. Saves 80-95% tokens on large codebases.

  • OPENGROK_DEFAULT_PROJECT

    Default project to scope all searches. Can be overridden per call.

  • OPENGROK_CONTEXT_BUDGET

    Response size tier controlling token usage.

  • OPENGROK_ENABLE_ELICITATION

    Enable interactive project picker at session start and env.opengrok.elicit() in Code Mode sandbox. Requires a supporting MCP client.

  • OPENGROK_SAMPLING_MODEL

    Model preference for MCP Sampling (used for error explanation and query reformulation).

Install in one click with Zurek

Browse here, install from the native macOS app — pick targets, fill env vars, and write configs safely.