# opengrok-mcp-server

> OpenGrok MCP Server is a native Model Context Protocol server that bridges your organization's OpenGrok search engine with AI assistants — enabling instant, natural language search and deep repository

- **URL**: https://www.freshcrate.ai/projects/opengrok-mcp-server
- **Author**: IcyHot09
- **Category**: MCP Servers
- **Latest version**: `v9.2.14` (2026-04-11)
- **License**: NOASSERTION
- **Source**: https://github.com/IcyHot09/opengrok-mcp-server
- **Language**: TypeScript
- **GitHub**: 2 stars, 1 forks
- **Registry**: github
- **Tags**: `code-search`, `copilot`, `github-copilot`, `mcp`, `mcp-server`, `model-context-protocol`, `opengrok`, `typescript`, `vscode-extension`

## Description

OpenGrok MCP Server is a native Model Context Protocol server that bridges your organization's OpenGrok search engine with AI assistants — enabling instant, natural language search and deep repository context across massive codebases.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v9.2.14` | 2026-04-11 | High | ## 🚀 What's New  See the [CHANGELOG](https://github.com/IcyHot09/opengrok-mcp-server/blob/main/CHANGELOG.md) 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. |
| `v9.2.13` | 2026-04-11 | Medium | ## 🚀 What's New  See the [CHANGELOG](https://github.com/IcyHot09/opengrok-mcp-server/blob/main/CHANGELOG.md) for the full list of changes in this release.  ## [9.2.13] - 2026-04-11  ### 🐛 Bug Fix — Code Mode Ignores `OPENGROK_DEFAULT_PROJECT` (+ API Spec Accuracy)  **Root cause:** All six sandbox methods that accept a `projects` parameter were passing the caller-supplied value straight through to `client.search()` without applying `OPENGROK_DEFAULT_PROJECT`. In Code Mode (the default), every s |
| `v9.2.12` | 2026-04-11 | Medium | ## 🚀 What's New  See the [CHANGELOG](https://github.com/IcyHot09/opengrok-mcp-server/blob/main/CHANGELOG.md) for the full list of changes in this release.  ## [9.2.12] - 2026-04-11  ### 🐛 Bug Fix — `setup` Re-Run Idempotence  Running `npx opengrok-mcp-server setup` when the MCP server was already configured would fail because both the Claude Code CLI (`claude mcp add`) and Copilot CLI (`copilot mcp add`) reject duplicate server names.  - **`configure.ts` — `configureClaudeCode()`**: Added `cla |
| `v9.2.11` | 2026-04-11 | Medium | ## 🚀 What's New  See the [CHANGELOG](https://github.com/IcyHot09/opengrok-mcp-server/blob/main/CHANGELOG.md) for the full list of changes in this release.  ## [9.2.11] - 2026-04-11  ### ✨ Feature — Full Configuration Surface Audit & Fixes  Complete audit of all 33 env vars against VS Code settings, config panel webview, CLI wizard, `configure.ts`, `extension.ts`, and `server.json`. All gaps resolved.  **Removed `OPENGROK_ENABLE_CACHE_HINTS` (dead code):** - Removed from `config.ts`, `server.ts` |
| `v9.2.10` | 2026-04-11 | Medium | ## 🚀 What's New  See the [CHANGELOG](https://github.com/IcyHot09/opengrok-mcp-server/blob/main/CHANGELOG.md) for the full list of changes in this release.  ## [9.2.10] - 2026-04-11  ### ✨ Feature — `OPENGROK_ENABLE_SAMPLING` Kill Switch (off by default)  MCP Sampling was consuming premium requests in clients such as GitHub Copilot even though the server was initiating it transparently. Sampling is now **disabled by default** and must be explicitly opted in.  - **`OPENGROK_ENABLE_SAMPLING`**: Ne |
| `v9.2.9` | 2026-04-10 | Medium | ## 🚀 What's New  See the [CHANGELOG](https://github.com/IcyHot09/opengrok-mcp-server/blob/main/CHANGELOG.md) for the full list of changes in this release.  ## [9.2.9] - 2026-04-10  ### 🐛 Bug Fix — Server Sourcemaps Excluded from npm Package  Dev-build sourcemaps (`out/server/main.js.map`, `out/server/sandbox-worker.js.map`) were inadvertently included in published npm packages when a developer ran `npm run compile` (dev build) before `npm publish`. The `files` field in `package.json` includes |
| `v9.2.8` | 2026-04-10 | Medium | ## 🚀 What's New  See the [CHANGELOG](https://github.com/IcyHot09/opengrok-mcp-server/blob/main/CHANGELOG.md) for the full list of changes in this release.  ## [9.2.8] - 2026-04-10  ### 🐛 Bug Fixes — `defs`/`refs` Search Reliability & `batchSearch` Resilience  **Root cause (cross-verified with live server):** `defs` and `refs` searches use the OpenGrok web search UI (`/search?defs=...`) because the REST API returns HTTP 400 for these fields on OpenGrok 1.7.x. The web UI requires a `project=` pa |
| `v9.2.7` | 2026-04-10 | Medium | ## 🚀 What's New  See the [CHANGELOG](https://github.com/IcyHot09/opengrok-mcp-server/blob/main/CHANGELOG.md) for the full list of changes in this release.  ## [9.2.7] - 2026-04-10  ### 🧠 Memory + Observation Masker UX  **Memory read at session start (all AI clients):** - `SERVER_INSTRUCTIONS_CODE_MODE_TEMPLATE` MEMORY section now explicitly instructs: "If prior context shown above, read both files with opengrok_read_memory before any other call. At session end: append to investigation-log.md a |
| `v9.2.5` | 2026-04-10 | Medium | ## 🚀 What's New  See the [CHANGELOG](https://github.com/IcyHot09/opengrok-mcp-server/blob/main/CHANGELOG.md) for the full list of changes in this release.  ## [9.2.5] - 2026-04-10  ### 🧹 Cleanup — Legacy Credential File Purge  `storeCredentials()` now removes old credential artifacts left by versions prior to v8.0 on first call (e.g. after `opengrok-mcp setup`): - `cred-{username}.key` — old separate key file (v8.x wrote key + enc separately) - `credentials.enc` — pre-`cred-{username}.enc` nam |
| `v9.2.4` | 2026-04-10 | Medium | ## 🚀 What's New  See the [CHANGELOG](https://github.com/IcyHot09/opengrok-mcp-server/blob/main/CHANGELOG.md) for the full list of changes in this release.  ## [9.2.4] - 2026-04-10  ### 🐛 Bug Fixes — `testConnection()` & `opengrok-mcp status`  - **`testConnection()` 429 fix**: Rewrote the method to bypass `pRetry` entirely. Previously it called `this.request()` which retried 429 responses 3× with exponential backoff (~7 s delay), causing test timeouts and unnecessary network load for a connecti |

## Citation

- HTML: https://www.freshcrate.ai/projects/opengrok-mcp-server
- Markdown: https://www.freshcrate.ai/projects/opengrok-mcp-server.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/opengrok-mcp-server/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._