Stateless MCP server that proxies research queries to Gemini CLI, reducing agent context/model usage
npx -y gemini-researcher{
"GEMINI_API_KEY": "YOUR_SECRET_VALUE",
"PROJECT_ROOT": "YOUR_VALUE_HERE",
"RESPONSE_CHUNK_SIZE_KB": "YOUR_VALUE_HERE",
"CACHE_TTL_MS": "YOUR_VALUE_HERE",
"DEBUG": "YOUR_VALUE_HERE",
"GOOGLE_APPLICATION_CREDENTIALS": "YOUR_VALUE_HERE",
"GOOGLE_CLOUD_PROJECT": "YOUR_VALUE_HERE",
"VERTEX_AI_PROJECT": "YOUR_VALUE_HERE"
}Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
{
"mcpServers": {
"io-github-capybearista-gemini-researcher": {
"command": "npx",
"args": [
"-y",
"gemini-researcher"
],
"env": {
"GEMINI_API_KEY": "YOUR_SECRET_VALUE",
"PROJECT_ROOT": "YOUR_VALUE_HERE",
"RESPONSE_CHUNK_SIZE_KB": "YOUR_VALUE_HERE",
"CACHE_TTL_MS": "YOUR_VALUE_HERE",
"DEBUG": "YOUR_VALUE_HERE",
"GOOGLE_APPLICATION_CREDENTIALS": "YOUR_VALUE_HERE",
"GOOGLE_CLOUD_PROJECT": "YOUR_VALUE_HERE",
"VERTEX_AI_PROJECT": "YOUR_VALUE_HERE"
}
}
}
}~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonNo remote HTTP endpoint is advertised. Use the package or stdio setup shown in Install.
gemini-researcher is an MCP server for Stateless MCP server that proxies research queries to Gemini CLI, reducing agent context/model usage. It supports STDIO transport.
Use the generated config in Install. This server runs with npx -y gemini-researcher; add any required environment variables before starting your client.
Choose the Claude Desktop tab in Install and copy the config for npx -y gemini-researcher. Add required environment variables before starting Claude Desktop.
Choose the Claude Code tab in Install and copy the config for npx -y gemini-researcher. Add required environment variables before starting Claude Code.
Choose the Codex tab in Install and copy the config for npx -y gemini-researcher. Add required environment variables before starting Codex.
Choose the Cursor or VS Code tab in Install and copy the config for npx -y gemini-researcher. Add required environment variables before starting Cursor or VS Code.
gemini-researcher uses STDIO transport. Use the package or command config in Install.
gemini-researcher inventory is listed when the MCP endpoint exposes tools, resources, or prompts. Some servers require auth first.
gemini-researcher does not advertise a verified auth requirement. If discovery fails, it may still need provider login, an API key, a bearer token, or a session header.
| Package | Registry | Version | Inputs |
|---|---|---|---|
gemini-researcherstdio | npm | 1.0.2 | Env: GEMINI_API_KEY secret Env: PROJECT_ROOT Env: RESPONSE_CHUNK_SIZE_KB Env: CACHE_TTL_MS Env: DEBUG Env: GOOGLE_APPLICATION_CREDENTIALS Env: GOOGLE_CLOUD_PROJECT Env: VERTEX_AI_PROJECT |