Gemini Docs MCP Server

A remote HTTP MCP server that provides tools to search and retrieve Google Gemini API documentation. The server exposes the MCP protocol at the /mcp endpoint and can be deployed to Cloud Run or other containerized platforms. It also supports local stdio mode for development.

• Search Documentation: Full-text search across all Gemini documentation pages.

• Get Capabilities: List available documentation pages or retrieve content for a specific page.

• Get Current Model: Quickly access documentation for current Gemini models.

• Automatic Updates: Scrapes and updates documentation on server startup.

How it Works

1. Ingestion: On startup, the server fetches https://ai.google.dev/gemini-api/docs/llms.txt to get a list of all available documentation pages.

2. Processing: It then concurrently fetches and processes each page, extracting the text content.

3. Indexing: The processed content is stored in a local SQLite database with a Full-Text Search (FTS5) index for efficient querying.

4. Searching: When you use the search_documentation tool, the server queries this SQLite database to find the most relevant documentation pages.

Installation

Option 1: Use uvx (Recommended)

You can use uvx to run the server directly without explicit installation. This is the easiest way to get started.

Option 2: Install directly from GitHub

You can install the package directly from GitHub using pip:

Option 3: Manual Installation (for development)

Usage

Running as a Remote HTTP Server

The server runs as an HTTP server and exposes the MCP protocol at the /mcp endpoint. It respects the PORT environment variable (defaults to 8080).

The server will be accessible at http://localhost:8080/mcp (or your configured port).

Docker Deployment

Build and run the Docker container:

Cloud Run Deployment

Deploy to Google Cloud Run:

The server will be accessible at https://<your-service-url>/mcp.

Running in Stdio Mode (Local)

If you don't set the PORT environment variable, the server runs in stdio mode for local MCP clients:

Configuration

The database is stored at:

• /tmp/gemini-api-docs/database.db in containerized environments

• ~/.mcp/gemini-api-docs/database.db in local environments

You can override this by setting the GEMINI_DOCS_DB_PATH environment variable.

Using with an MCP Client

For remote HTTP servers, configure your MCP client to connect via HTTP:

For local development with stdio (if supported by your client):

Tools

• search_documentation(queries: list[str]): Performs a full-text search on Gemini documentation for the given list of queries (max 3).

• get_capability_page(capability: str = None): Get a list of capabilities or content for a specific one.

• get_current_model(): Get documentation for current Gemini models.

License

MIT

Test Results

We run a comprehensive evaluation harness to ensure the MCP server provides accurate and up-to-date code examples. The tests cover both Python and TypeScript SDKs.

Last updated: 2025-11-03 13:29:01

You can find the detailed test results in tests/result.json.