Cloudflare AutoRAG MCP Server

A Model Context Protocol (MCP) server that provides search capabilities for Cloudflare AutoRAG instances. This server enables AI assistants like Claude to directly search and query your AutoRAG knowledge base using three distinct search methods.

Features

• Basic Search - Vector similarity search without query rewriting or answer generation
• Rewrite Search - Vector search with AI query rewriting but no answer generation (returns document chunks only)
• AI Search - Full AI-powered search with optional AI response and configurable query rewriting
• Configurable Parameters - Support for score_threshold (default: 0.5) and max_num_results (1-50, default: 10)
• Pagination Support - AI search supports cursor-based pagination for large result sets (v1.2.0+)
• Multi-AutoRAG Support - Manage and search across multiple AutoRAG instances (v2.0.0+)
• Remote Deployment - Runs on Cloudflare Workers for scalability
• MCP Compatible - Works with Claude Desktop and other MCP clients

Tools

autorag_basic_search

Performs a basic vector similarity search in your Cloudflare AutoRAG index without AI query rewriting or answer generation. Returns raw document chunks only.

Parameters:

• query (string, required) - The search query text (max 10,000 characters)
• score_threshold (number, optional) - Minimum similarity score threshold (0.0-1.0, default: 0.5)
• max_num_results (number, optional) - Maximum number of results to return (1-50, default: 10)
• autorag_name (string, optional) - Name of the AutoRAG instance to use (defaults to configured default)

autorag_rewrite_search

Performs a vector search with AI query rewriting but no answer generation. Uses Cloudflare's search() method with configurable rewrite_query for better semantic matching and returns only document chunks.

Parameters:

• query (string, required) - The search query text (max 10,000 characters)
• score_threshold (number, optional) - Minimum similarity score threshold (0.0-1.0, default: 0.5)
• max_num_results (number, optional) - Maximum number of results to return (1-50, default: 10)
• rewrite_query (boolean, optional) - Whether to rewrite query for better matching (default: true)
• autorag_name (string, optional) - Name of the AutoRAG instance to use (defaults to configured default)

autorag_ai_search

Performs AI-powered search using Cloudflare's aiSearch() method with optional AI-generated response. Returns document chunks and optionally an AI answer based on the include_ai_response parameter. Supports pagination for large result sets.

Parameters:

• query (string, required) - The search query text (max 10,000 characters)
• score_threshold (number, optional) - Minimum similarity score threshold (0.0-1.0, default: 0.5)
• max_num_results (number, optional) - Maximum number of results to return (1-50, default: 10)
• rewrite_query (boolean, optional) - Whether to rewrite the query for better semantic matching (default: true)
• include_ai_response (boolean, optional) - Whether to include the AI-generated response in the output (default: false)
• cursor (string, optional) - Pagination cursor from previous response to fetch next page of results (v1.2.0+)
• autorag_name (string, optional) - Name of the AutoRAG instance to use (defaults to configured default)

Response includes:

• data - Array of source document chunks with scores and metadata (always included)
• response - AI-generated answer based on retrieved documents (only when include_ai_response: true)
• has_more - Boolean indicating if more results are available
• next_page - Cursor token for fetching the next page (when has_more is true)
• nextCursor - MCP-compliant cursor field (mirrors next_page value)

list_autorags (v2.0.0+)

Lists all available AutoRAG instances configured in the server.

Parameters: None

Response includes:

• autorags - Array of AutoRAG instances with name, description, and is_default flag
• total - Total number of configured AutoRAG instances
• default - Name of the default AutoRAG instance

get_current_autorag (v2.0.0+)

Gets information about the currently configured default AutoRAG instance.

Parameters: None

Response includes:

• current_autorag - Name of the current default AutoRAG instance
• description - Description of the instance
• is_default - Always true for this endpoint

Prerequisites

1. Cloudflare Account with AutoRAG access
2. AutoRAG Instance - Created and indexed in your Cloudflare account
3. Wrangler CLI - For deployment (npm install --save-dev wrangler)

Deployment

1. Clone the repository:

   git clone <repository-url>
   cd cf-autorag-mcp
   

2. Install dependencies:

   npm install
   

3. Configure your AutoRAG instance: Edit wrangler.toml and update the configuration:

   For a single AutoRAG instance:

   [vars]
   AUTORAG_NAME = "your-autorag-instance-name"
   

   For multiple AutoRAG instances:

   [vars]
   AUTORAG_INSTANCES = "instance1,instance2,instance3"
   AUTORAG_DESCRIPTIONS = "Description 1,Description 2,Description 3"
   

4. Deploy to Cloudflare Workers:

   npx wrangler deploy
   

   This will output your Worker URL, which you'll need for the MCP client configuration.

Claude Desktop Configuration

To use this MCP server with Claude Desktop, add the following configuration to your Claude Desktop config file:

macOS

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

Windows

Edit %APPDATA%/Claude/claude_desktop_config.json:

Configuration

{
  "mcpServers": {
    "cf-autorag-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-worker-url.workers.dev/"
      ]
    }
  }
}

**Replace `https://your-worker-url.workers.dev…