io.github.capyBearista/gemini-researcher MCP Server

Name: io.github.capyBearista/gemini-researcher MCP Server
Author: io.github.capyBearista

io.github.capyBearista/gemini-researcher

Repository Registry

What is the io.github.capyBearista/gemini-researcher MCP server?

Stateless MCP server that proxies research queries to Gemini CLI, reducing agent context/model usage

How to install io.github.capyBearista/gemini-researcher

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

GEMINI_API_KEY
secret
Gemini API key (optional if you already authenticated Gemini CLI via "gemini" login)
PROJECT_ROOT
Override the project root directory used for path validation (defaults to current working directory)
RESPONSE_CHUNK_SIZE_KB
Chunk size threshold (KB) for large responses (default: 10)
CACHE_TTL_MS
Chunk cache TTL in milliseconds (default: 3600000 / 1 hour)
DEBUG
Enable debug logging (set to "true" or "1")
GOOGLE_APPLICATION_CREDENTIALS
Vertex AI / Google auth: path to a service account JSON credentials file
GOOGLE_CLOUD_PROJECT
Vertex AI / Google auth: GCP project ID (used by some auth configurations)
VERTEX_AI_PROJECT
Vertex AI / Google auth: Vertex AI project identifier (used by some auth configurations)

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "gemini-researcher": {
      "command": "npx",
      "args": [
        "-y",
        "gemini-researcher"
      ],
      "env": {
        "GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>",
        "PROJECT_ROOT": "<YOUR_PROJECT_ROOT>",
        "RESPONSE_CHUNK_SIZE_KB": "<YOUR_RESPONSE_CHUNK_SIZE_KB>",
        "CACHE_TTL_MS": "<YOUR_CACHE_TTL_MS>",
        "DEBUG": "<YOUR_DEBUG>",
        "GOOGLE_APPLICATION_CREDENTIALS": "<YOUR_GOOGLE_APPLICATION_CREDENTIALS>",
        "GOOGLE_CLOUD_PROJECT": "<YOUR_GOOGLE_CLOUD_PROJECT>",
        "VERTEX_AI_PROJECT": "<YOUR_VERTEX_AI_PROJECT>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "gemini-researcher": {
      "command": "npx",
      "args": [
        "-y",
        "gemini-researcher"
      ],
      "env": {
        "GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>",
        "PROJECT_ROOT": "<YOUR_PROJECT_ROOT>",
        "RESPONSE_CHUNK_SIZE_KB": "<YOUR_RESPONSE_CHUNK_SIZE_KB>",
        "CACHE_TTL_MS": "<YOUR_CACHE_TTL_MS>",
        "DEBUG": "<YOUR_DEBUG>",
        "GOOGLE_APPLICATION_CREDENTIALS": "<YOUR_GOOGLE_APPLICATION_CREDENTIALS>",
        "GOOGLE_CLOUD_PROJECT": "<YOUR_GOOGLE_CLOUD_PROJECT>",
        "VERTEX_AI_PROJECT": "<YOUR_VERTEX_AI_PROJECT>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "gemini-researcher": {
      "command": "npx",
      "args": [
        "-y",
        "gemini-researcher"
      ],
      "env": {
        "GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>",
        "PROJECT_ROOT": "<YOUR_PROJECT_ROOT>",
        "RESPONSE_CHUNK_SIZE_KB": "<YOUR_RESPONSE_CHUNK_SIZE_KB>",
        "CACHE_TTL_MS": "<YOUR_CACHE_TTL_MS>",
        "DEBUG": "<YOUR_DEBUG>",
        "GOOGLE_APPLICATION_CREDENTIALS": "<YOUR_GOOGLE_APPLICATION_CREDENTIALS>",
        "GOOGLE_CLOUD_PROJECT": "<YOUR_GOOGLE_CLOUD_PROJECT>",
        "VERTEX_AI_PROJECT": "<YOUR_VERTEX_AI_PROJECT>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "gemini-researcher": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "gemini-researcher"
      ],
      "env": {
        "GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>",
        "PROJECT_ROOT": "<YOUR_PROJECT_ROOT>",
        "RESPONSE_CHUNK_SIZE_KB": "<YOUR_RESPONSE_CHUNK_SIZE_KB>",
        "CACHE_TTL_MS": "<YOUR_CACHE_TTL_MS>",
        "DEBUG": "<YOUR_DEBUG>",
        "GOOGLE_APPLICATION_CREDENTIALS": "<YOUR_GOOGLE_APPLICATION_CREDENTIALS>",
        "GOOGLE_CLOUD_PROJECT": "<YOUR_GOOGLE_CLOUD_PROJECT>",
        "VERTEX_AI_PROJECT": "<YOUR_VERTEX_AI_PROJECT>"
      }
    }
  }
}

Claude Code

claude mcp add gemini-researcher --env GEMINI_API_KEY=<YOUR_GEMINI_API_KEY> --env PROJECT_ROOT=<YOUR_PROJECT_ROOT> --env RESPONSE_CHUNK_SIZE_KB=<YOUR_RESPONSE_CHUNK_SIZE_KB> --env CACHE_TTL_MS=<YOUR_CACHE_TTL_MS> --env DEBUG=<YOUR_DEBUG> --env GOOGLE_APPLICATION_CREDENTIALS=<YOUR_GOOGLE_APPLICATION_CREDENTIALS> --env GOOGLE_CLOUD_PROJECT=<YOUR_GOOGLE_CLOUD_PROJECT> --env VERTEX_AI_PROJECT=<YOUR_VERTEX_AI_PROJECT> -- npx -y gemini-researcher