gemini-code-context-mcp

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

stdiocommunityinfra

Package Details

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

1.5.2•https://www.npmjs.com/package/@qmediat.io/gemini-code-context-mcp

Transportstdio

Environment Variables

GEMINI_CREDENTIALS_PROFILE(str)

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(str)

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(str)

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

GOOGLE_CLOUD_PROJECT(str)

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

GEMINI_DAILY_BUDGET_USD(str)

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(str)

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(str)

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(str)

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