Skip to main content
Glama
Gemini RAG MCP Server
by masseater

Gemini RAG MCP Server

A Model Context Protocol (MCP) server that provides RAG (Retrieval-Augmented Generation) capabilities using Google's Gemini API File Search feature. This server enables AI applications to create knowledge bases and retrieve information from uploaded documents.

Features

  • ✅ File Search RAG: Create and manage knowledge bases using Gemini's File Search API

  • ✅ Document Upload: Upload files and text content to create searchable knowledge bases

  • ✅ Information Retrieval: Query knowledge bases to retrieve relevant information

  • ✅ Configurable Models: Choose Gemini models via environment variable

  • ✅ MCP Protocol: Full compatibility with Model Context Protocol

  • ✅ Type-Safe: Full TypeScript support with strict mode enabled

  • ✅ Dual Transport Support: stdio (default) and HTTP transports

  • ✅ Production-Ready: Logging, error handling, and configuration management

Related MCP server: MCP RAG Server

Prerequisites

  • Node.js >= 22.10.0

  • pnpm >= 10.19.0

  • Google API Key with Gemini API access

Installation

Add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "gemini-rag-mcp": {
      "command": "npx",
      "args": ["-y", "@r_masseater/gemini-rag-mcp"],
      "env": {
        "GOOGLE_API_KEY": "your_google_api_key_here",
        "STORE_DISPLAY_NAME": "your_store_name"
      }
    }
  }
}

Required Environment Variables:

  • GOOGLE_API_KEY: Your Google API key with Gemini API access

  • STORE_DISPLAY_NAME: Display name for your vector store/knowledge base

Optional Environment Variables:

  • GEMINI_MODEL: Gemini model to use for queries (default: gemini-2.5-pro)

    • Options: gemini-2.5-pro, gemini-2.5-flash

After configuration, restart Claude Desktop to load the server.

Development

1. Clone the repository

git clone https://github.com/masseater/gemini-rag-mcp.git
cd gemini-rag-mcp

2. Install dependencies

pnpm install

3. Run in development mode

# stdio transport (default)
pnpm run dev

# HTTP transport (with hot reload)
pnpm run dev:http

Environment Variables

Required:

  • GOOGLE_API_KEY: Google API key with Gemini API access

  • STORE_DISPLAY_NAME: Display name for vector store/knowledge base

Optional:

  • GEMINI_MODEL: Gemini model for queries (default: gemini-2.5-pro)

  • LOG_LEVEL: Logging level (error|warn|info|debug, default: info)

  • DEBUG: Enable debug console output (true|false, default: false)

  • PORT: HTTP server port (default: 3000)

Available Tools

Once configured with Claude Desktop, the following tools are available:

  • upload_file: Upload document files to the knowledge base

  • upload_content: Upload text content directly to the knowledge base

  • query: Query the knowledge base using RAG

Resources

License

MIT License

Available Tools

3 tools
queryB

Query the FileSearchStore using RAG (Retrieval-Augmented Generation) to get answers based on uploaded documents. The AI will search through the documents and provide relevant answers with citations.

Inputs: query (required).

upload_contentC

Upload text content to the FileSearchStore for RAG indexing. The content will be processed and made searchable.

Inputs: content (required), displayName (required), metadata.

upload_fileB

Upload a file to the FileSearchStore for RAG indexing. The file will be processed and made searchable.

Inputs: filePath (required), mimeType, displayName, metadata.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: querying for answers, uploading text content, and uploading files. There is no overlap in functionality, and an agent can easily tell them apart based on their specific roles in the RAG workflow.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (query, upload_content, upload_file) with clear, descriptive terms. The naming is uniform and predictable, making it easy for agents to understand and use the tools.

    Tool Count4/5

    With 3 tools, the server is well-scoped for a RAG system, covering core operations: querying, uploading text, and uploading files. It is slightly lean but reasonable, as it handles the essential workflow without unnecessary complexity.

    Completeness4/5

    The tool set covers the main RAG operations: ingestion (uploading content/files) and retrieval (querying). Minor gaps might include tools for managing or deleting uploaded content, but the core functionality is complete for basic RAG use cases.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables RAG (Retrieval-Augmented Generation) capabilities with document processing, vector storage, and intelligent Q\&A using OpenAI embeddings and semantic search.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to search and retrieve information from your knowledge base using RAG (Retrieval-Augmented Generation) with hybrid search, document indexing, and ChromaDB vector storage.
      35 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables uploading, organizing, and semantically searching documents with support for various file types and embedding providers.
      28 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables document Q&A with grounded citations using the official Gemini File Search API. Upload documents, create stores, and ask questions that return exact passage citations.
      7
      15 npm
      2
      MIT