← Index

OpenGrok MCP Server

io.github.IcyHot09/opengrok-mcp-server·v9.0.1·Search
Quality Score
95
/100

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

§01  Install
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "opengrok-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "opengrok-mcp-server"
      ],
      "env": {
        "OPENGROK_BASE_URL": "<opengrok_base_url>",
        "OPENGROK_USERNAME": "<opengrok_username>",
        "OPENGROK_PASSWORD": "<your-opengrok_password>",
        "OPENGROK_VERIFY_SSL": "true",
        "OPENGROK_CODE_MODE": "false",
        "OPENGROK_DEFAULT_PROJECT": "<opengrok_default_project>",
        "OPENGROK_CONTEXT_BUDGET": "minimal",
        "OPENGROK_ENABLE_ELICITATION": "false",
        "OPENGROK_SAMPLING_MODEL": "<opengrok_sampling_model>"
      }
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "opengrok-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "opengrok-mcp-server"
      ],
      "env": {
        "OPENGROK_BASE_URL": "<opengrok_base_url>",
        "OPENGROK_USERNAME": "<opengrok_username>",
        "OPENGROK_PASSWORD": "<your-opengrok_password>",
        "OPENGROK_VERIFY_SSL": "true",
        "OPENGROK_CODE_MODE": "false",
        "OPENGROK_DEFAULT_PROJECT": "<opengrok_default_project>",
        "OPENGROK_CONTEXT_BUDGET": "minimal",
        "OPENGROK_ENABLE_ELICITATION": "false",
        "OPENGROK_SAMPLING_MODEL": "<opengrok_sampling_model>"
      }
    }
  }
}
Cline (cline_mcp_settings.json)
npx -y opengrok-mcp-server
§02  Environment variables
OPENGROK_BASE_URL
required

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

OPENGROK_USERNAME
required

OpenGrok authentication username

OPENGROK_PASSWORD
secret

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).

§03  MCP Quality Score  ·  methodology
freshness
25
completeness
20
installability
25
documentation
15
stability
10
§04  Alternatives in Search