PixelRAG MCP Server 🚀

An open-source Visual Retrieval-Augmented Generation (Visual RAG) MCP server based on PixelRAG and FastMCP, designed for 24/7 remote hosting via SSE (Server-Sent Events) on platforms like Railway.

🌟 Features

• Visual RAG Tooling: Render web pages, PDFs, or design screenshot folders into visual tiles and query them via multimodal vision embeddings.

• FastMCP SSE Transport: Exposed over HTTP/HTTPS with Server-Sent Events for 24/7 remote access by Antigravity, Claude Code, Cursor, and VS Code.

• Production Ready Docker Setup: Includes Playwright headless Chromium pre-configured for web page screenshot rendering.

Related MCP server: image-tiler-mcp-server

🛠️ Included Tools

1. index_document: Renders visual tiles from PDF files, image folders, or live URLs, building an indexed vector space.

2. query_visual_index: Queries screenshot tiles using natural language prompts.

3. health_check: Returns operational status of the MCP server.

🚀 Deploying to Railway

1. Click + New Project $\rightarrow$ Deploy from GitHub repo.

2. Select pixelrag-mcp-server.

3. In Settings $\rightarrow$ Networking, click Generate Domain.

4. Use your public SSE URL:

   https://<YOUR-RAILWAY-APP>.up.railway.app/sse

🔌 Connecting to Antigravity / MCP Client

Add the following to your MCP settings file:

{
  "mcpServers": {
    "pixelrag": {
      "url": "https://<YOUR-RAILWAY-APP>.up.railway.app/sse"
    }
  }
}