🚀 What's New
See the CHANGELOG for the full list of changes in this release.
[9.2.14] - 2026-04-11
🐛 Bug Fix — Correct fileType API Parameter Values + API Spec Accuracy
fileType values were wrong: The API spec documented fileType as a lowercase file extension (e.g. 'cpp', 'go', 'sh') but OpenGrok actually accepts the lowercased analyzer class name with the 'analyzer' suffix stripped (e.g. CxxAnalyzer → 'cxx', GolangAnalyzer → 'golang', ShAnalyzer → 'sh'). The screenshot-confirmed value type=cxx in the OpenGrok search URL is the canonical form, derived from FileAnalyzer.getFileTypeName() at runtime.
Updated fileType_note in API_SPEC.methods.search with the correct and complete list:
'cxx' (C++), 'c' (C/headers), 'java', 'javascript', 'typescript', 'csharp' (C#), 'python', 'sh' (shell), 'powershell', 'golang' (Go), 'rust', 'kotlin', 'scala', 'sql', 'plsql', 'perl', 'ruby', 'swift', 'php', 'xml', 'json', 'yaml', 'hcl', 'terraform', 'lua', 'ada', 'fortran', 'r', 'haskell', 'clojure', 'erlang', 'lisp', 'ocaml', 'tcl', 'pascal', 'eiffel', 'asm', 'vb' (Visual Basic), 'verilog', 'plain'.
Additional API spec fixes:
search()opts: documented defaults —searchTypedefaults to'full',maxResultsto5,startIndexto0.search()returns: added_suggestions?: string[]to the type signature (only present whenOPENGROK_ENABLE_SAMPLING=trueandtotalCount === 0).search()project_note: corrected —OPENGROK_DEFAULT_PROJECTis auto-injected for all search types (not justdefs/refs).search()defs_refs_note: corrected — defs/refs don't hard-fail without a project, but may return noisy cross-project results.batchSearch()queries: documentedmaxResultsdefault of5.batchSearch()note: documented that pagination (startIndex) is not supported — always fetches from offset 0.return_rules[1]: replaced "the default is too high" with accurate statement — default is5.importantnote on_suggestions: clarified that auto-population only occurs whenOPENGROK_ENABLE_SAMPLING=true.
📦 Getting Started
VS Code Extension
- Download opengrok-mcp-server-9.2.14.vsix from the Assets section below
- Open VS Code → Extensions → ··· → Install from VSIX…
- Select the downloaded file — done!
💡 Already on v3.1 or later? The extension checks for updates automatically.
Standalone MCP Server
One-line install for any MCP-compatible client:
See the install guide for setup instructions.
Supported clients: Claude Code · Cursor · Windsurf · Claude Desktop · OpenCode · and more
📖 Documentation
| Resource | Description |
|---|---|
| README | VS Code extension setup & configuration |
| MCP Clients Guide | Per-client config for standalone server |
| Changelog | Full version history |