io.github.capyBearista/gemini-researcher

io.github.capyBearista/gemini-researcher·v1.0.2·AI & LLMs

Quality Score

/100

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

Repository →

§01 Install

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "gemini-researcher": {
      "command": "npx",
      "args": [
        "-y",
        "gemini-researcher"
      ],
      "env": {
        "GEMINI_API_KEY": "<your-gemini_api_key>",
        "PROJECT_ROOT": "<project_root>",
        "RESPONSE_CHUNK_SIZE_KB": "<response_chunk_size_kb>",
        "CACHE_TTL_MS": "<cache_ttl_ms>",
        "DEBUG": "<debug>",
        "GOOGLE_APPLICATION_CREDENTIALS": "<google_application_credentials>",
        "GOOGLE_CLOUD_PROJECT": "<google_cloud_project>",
        "VERTEX_AI_PROJECT": "<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": "<project_root>",
        "RESPONSE_CHUNK_SIZE_KB": "<response_chunk_size_kb>",
        "CACHE_TTL_MS": "<cache_ttl_ms>",
        "DEBUG": "<debug>",
        "GOOGLE_APPLICATION_CREDENTIALS": "<google_application_credentials>",
        "GOOGLE_CLOUD_PROJECT": "<google_cloud_project>",
        "VERTEX_AI_PROJECT": "<vertex_ai_project>"
      }
    }
  }
}

Cline (cline_mcp_settings.json)

npx -y gemini-researcher

§02 Environment variables

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)

§03 MCP Quality Score · methodology

freshness

completeness

installability

documentation

stability

§04 Alternatives in AI & LLMs

OpenAI Tools MCP Server

ai.com.mcp/openai-tools

Focused MCP server for OpenAI image/audio generation (v2.0.0). Wraps endpoints via HAPI CLI.

ai.llmse/mcp

Public MCP server for the LLM Search Engine

Perplexity API Platform

ai.perplexity/mcp-server

Real-time web search, reasoning, and research through Perplexity's API