io.github.qmediat/gemini-code-context-mcp

io.github.qmediat/gemini-code-context-mcp·v1.16.2·AI & LLMs

Quality Score

/100

Gemini 2M context cache for Claude Code — persistent; repeat queries ~8x faster, ~4x cheaper.

Repository →

§01 Install

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "gemini-code-context-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@qmediat.io/gemini-code-context-mcp"
      ],
      "env": {
        "GEMINI_CREDENTIALS_PROFILE": "<gemini_credentials_profile>",
        "GEMINI_API_KEY": "<your-gemini_api_key>",
        "GEMINI_USE_VERTEX": "<gemini_use_vertex>",
        "GOOGLE_CLOUD_PROJECT": "<google_cloud_project>",
        "GEMINI_DAILY_BUDGET_USD": "<gemini_daily_budget_usd>",
        "GEMINI_CODE_CONTEXT_DEFAULT_MODEL": "<gemini_code_context_default_model>",
        "GEMINI_CODE_CONTEXT_CACHE_TTL_SECONDS": "<gemini_code_context_cache_ttl_seconds>",
        "GEMINI_CODE_CONTEXT_LOG_LEVEL": "<gemini_code_context_log_level>"
      }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "gemini-code-context-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@qmediat.io/gemini-code-context-mcp"
      ],
      "env": {
        "GEMINI_CREDENTIALS_PROFILE": "<gemini_credentials_profile>",
        "GEMINI_API_KEY": "<your-gemini_api_key>",
        "GEMINI_USE_VERTEX": "<gemini_use_vertex>",
        "GOOGLE_CLOUD_PROJECT": "<google_cloud_project>",
        "GEMINI_DAILY_BUDGET_USD": "<gemini_daily_budget_usd>",
        "GEMINI_CODE_CONTEXT_DEFAULT_MODEL": "<gemini_code_context_default_model>",
        "GEMINI_CODE_CONTEXT_CACHE_TTL_SECONDS": "<gemini_code_context_cache_ttl_seconds>",
        "GEMINI_CODE_CONTEXT_LOG_LEVEL": "<gemini_code_context_log_level>"
      }
    }
  }
}

Cline (cline_mcp_settings.json)

npx -y @qmediat.io/gemini-code-context-mcp

§02 Environment variables

GEMINI_CREDENTIALS_PROFILE

Profile name in ~/.config/qmediat/credentials (chmod 0600). Created by `npx @qmediat.io/gemini-code-context-mcp init`. Recommended; keeps your API key out of ~/.claude.json.

GEMINI_API_KEY

secret

Fallback Tier 3 auth. Your Gemini API key. Emits a warning at startup recommending you move it to the credentials profile via the init command.

GEMINI_USE_VERTEX

Set to `true` to use Vertex AI backend via Application Default Credentials. Requires GOOGLE_CLOUD_PROJECT.

GOOGLE_CLOUD_PROJECT

GCP project ID when using Vertex AI backend. Only read when GEMINI_USE_VERTEX=true.

GEMINI_DAILY_BUDGET_USD

Hard daily USD cap enforced locally. Server refuses calls after the cap until UTC midnight. Unlimited if unset. Honoured by `ask`, `code`, and per-iteration by `ask_agentic`.

GEMINI_CODE_CONTEXT_DEFAULT_MODEL

Model alias (`latest-pro`, `latest-pro-thinking`, `latest-flash`, `latest-lite`, `latest-vision`) or literal model ID. Default: `latest-pro`.

GEMINI_CODE_CONTEXT_CACHE_TTL_SECONDS

Context Cache TTL in seconds. Default: 3600 (1 hour). Hot workspaces (<10 min since last use) auto-refresh via background watcher.

GEMINI_CODE_CONTEXT_LOG_LEVEL

`debug` | `info` | `warn` | `error`. Default: `info`.

§03 MCP Quality Score · methodology

freshness

completeness

installability

documentation

stability