Gemini Researcher
by capybearistacommunityv1.0.2
Gemini Researcher is a lightweight, stateless MCP server that allows developer agents to perform deep repository analysis using the Gemini CLI, returning structured JSON results.
From the registry: Stateless MCP server that proxies research queries to Gemini CLI, reducing agent context/model usage
Install & configure
Prerequisites
- requiredNode.js 18+Requires Node.js 18 or later
- requiredGemini CLIInstall Google's Gemini CLI globally
$ npm install -g @google/gemini-cli - requiredAuthenticate Gemini CLIRun gemini and login with Google, or set GEMINI_API_KEY
$ gemini
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `gemini-researcher` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Node.js 18+** — Requires Node.js 18 or later
- **Gemini CLI** — Install Google's Gemini CLI globally Run: `npm install -g @google/gemini-cli`
- **Authenticate Gemini CLI** — Run gemini and login with Google, or set GEMINI_API_KEY Run: `gemini`
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["gemini-researcher"]
- optional environment variables:
- `PROJECT_ROOT`: Override project root directory for analysis (example: `<your-project-path>`)
- `GEMINI_API_KEY`: Gemini API key (alternative to CLI login) (example: `<your-gemini-api-key>`)
- `GEMINI_RESEARCHER_ENFORCE_ADMIN_POLICY`: Set to 0/false to relax read-only policy enforcement (example: `1`)
Note: Stateless, read-only MCP that hands off deep repo analysis to Gemini CLI. Reduces calling agent's token/context usage.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Stateless, read-only MCP that hands off deep repo analysis to Gemini CLI. Reduces calling agent's token/context usage.
Tools (6)
quick_query
Fast analysis with flash model for quick questions about specific files or small code sections.
deep_research
In-depth analysis with pro model for complex multi-file analysis, architecture reviews, and security audits.
analyze_directory
Maps directory structure to understand unfamiliar codebases and generate project overviews.
validate_paths
Pre-checks file paths to verify files exist before running expensive queries.
health_check
Provides diagnostics for troubleshooting server and Gemini CLI issues.
fetch_chunk
Retrieves remaining parts of large responses.
Environment variables
GEMINI_API_KEYrequiredRequired for authenticating the Gemini CLI.GEMINI_RESEARCHER_ENFORCE_ADMIN_POLICYControls strict enforcement of the read-only policy.PROJECT_ROOTSets the project root directory for analysis.Prerequisites
- • Node.js 18+
Packages
gemini-researcher
npmv1.0.2transport: stdio
Details
- Language
- TypeScript
- License
- MPL-2.0
- Released
- Jan 26, 2026
- Last commit
- Apr 18, 2026
- Registry name
- io.github.capyBearista/gemini-researcher