Gemini-code-context-mcp Server

Codebase Q&A for Claude Code through Gemini's 1M-token window, with workspace scans and caching.

Local serverstdio

What is the Gemini-code-context-mcp Server?

Gemini-code-context-mcp is an MCP integration. Codebase Q&A for Claude Code through Gemini's 1M-token window, with workspace scans and caching.

Packages and local setup

The published npm package is @qmediat.io/gemini-code-context-mcp, version 1.20.0. Its declared MCP transport is stdio.

The package declares 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: 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-thinking, latest-pro, latest-flash, latest-lite, latest-vision) or literal model ID, read by ask, ask_agentic and code. Default: latest-pro-thinking (the thinking tier). code replaces a configured default that resolves but cannot reason or think with latest-pro-thinking and reports it as configuredModelReplaced; a default that does not resolve fails every tool.; GEMINI_CODE_CONTEXT_CACHING_MODE: implicit (default since v1.14.0: the workspace text is sent inline, Gemini's automatic prefix cache decides any discount) or explicit (Files API upload + Context Cache with Google's cached-input price). Per-call cachingMode wins.; GEMINI_CODE_CONTEXT_CACHE_TTL_SECONDS: Context Cache TTL in seconds in explicit caching mode. 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..

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository. This profile uses version 1.20.0 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related developer tools MCP servers for tools that cover the same kind of work.

Configuration

VariableDescriptionRequired
GEMINI_CREDENTIALS_PROFILEProfile 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.Optional
GEMINI_API_KEYFallback Tier 3 auth. Your Gemini API key. Emits a warning at startup recommending you move it to the credentials profile via the init command.Optional
GEMINI_USE_VERTEXSet to true to use Vertex AI backend via Application Default Credentials. Requires GOOGLE_CLOUD_PROJECT.Optional
GOOGLE_CLOUD_PROJECTGCP project ID when using Vertex AI backend. Only read when GEMINI_USE_VERTEX=true.Optional
GEMINI_DAILY_BUDGET_USDHard 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.Optional
GEMINI_CODE_CONTEXT_DEFAULT_MODELModel alias (latest-pro-thinking, latest-pro, latest-flash, latest-lite, latest-vision) or literal model ID, read by ask, ask_agentic and code. Default: latest-pro-thinking (the thinking tier). code replaces a configured default that resolves but cannot reason or think with latest-pro-thinking and reports it as configuredModelReplaced; a default that does not resolve fails every tool.Optional
GEMINI_CODE_CONTEXT_CACHING_MODEimplicit (default since v1.14.0: the workspace text is sent inline, Gemini's automatic prefix cache decides any discount) or explicit (Files API upload + Context Cache with Google's cached-input price). Per-call cachingMode wins.Optional
GEMINI_CODE_CONTEXT_CACHE_TTL_SECONDSContext Cache TTL in seconds in explicit caching mode. Default: 3600 (1 hour). Hot workspaces (<10 min since last use) auto-refresh via background watcher.Optional
GEMINI_CODE_CONTEXT_LOG_LEVELdebug | info | warn | error. Default: info.Optional