Gemini File Search RAG MCP Server

MCP (Model Context Protocol) server for Google's Gemini File Search (RAG). Manage file search stores, upload documents, and query with RAG through 12 tools.

Works with Claude Desktop, Cursor, VS Code, and any MCP client.

Quick Start

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "gemini-rag": {
      "command": "npx",
      "args": ["-y", "@node2flow/gemini-file-search-rag-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key"
      }
    }
  }
}

Cursor / VS Code

Add to MCP settings:

{
  "mcpServers": {
    "gemini-rag": {
      "command": "npx",
      "args": ["-y", "@node2flow/gemini-file-search-rag-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key"
      }
    }
  }
}

HTTP Mode (Streamable HTTP)

For remote deployment or shared access:

GEMINI_API_KEY=your_key npx @node2flow/gemini-file-search-rag-mcp --http

Server starts on port 3000 (configurable via PORT env var). MCP endpoint: http://localhost:3000/mcp

Related MCP server: estudIA-MCP

Configuration

All Tools (12 tools)

Store Management (4 tools)

Upload & Import (2 tools)

Operations (2 tools)

Document Management (3 tools)

RAG Query (1 tool)

Requirements

• Node.js 18+

• Google Gemini API key

How to Get a Gemini API Key

1. Go to Google AI Studio

2. Click "Create API key"

3. Copy the key and use it as GEMINI_API_KEY

For Developers

git clone https://github.com/node2flow-th/gemini-files-search-rag-mcp-community.git
cd gemini-files-search-rag-mcp-community
npm install
npm run build

# Run in stdio mode
GEMINI_API_KEY=your_key npm start

# Run in dev mode (hot reload)
GEMINI_API_KEY=your_key npm run dev

# Run in HTTP mode
GEMINI_API_KEY=your_key npm start -- --http

License

MIT License - see LICENSE

Copyright (c) 2026 Node2Flow

Links

• npm Package

• Google AI Studio

• MCP Protocol

• Node2Flow