MCP Server — Quickstart¶

The flexible-graphrag-mcp package is a standalone MCP server that connects Claude Desktop, Cursor, and other MCP clients to the Flexible GraphRAG backend.

Step 1 — Install the MCP server¶

# uvx downloads and runs automatically — nothing to pre-install
uvx flexible-graphrag-mcp

pipx install flexible-graphrag-mcp

pip install flexible-graphrag-mcp
# or
uv pip install flexible-graphrag-mcp

Step 2 — Start the backend¶

The backend must be running before MCP clients can connect.

uv venv venv-3.13 --python 3.13
venv-3.13\Scripts\Activate   # Windows
source venv-3.13/bin/activate  # Linux/macOS
uv pip install flexible-graphrag
flexible-graphrag

Backend runs at http://localhost:8000.

Step 3 — Connect Claude Desktop¶

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "flexible-graphrag": {
      "command": "uvx",
      "args": ["flexible-graphrag-mcp"],
      "env": {
        "FLEXIBLE_GRAPHRAG_API_BASE": "http://localhost:8000"
      }
    }
  }
}

{
  "mcpServers": {
    "flexible-graphrag": {
      "command": "flexible-graphrag-mcp",
      "env": {
        "FLEXIBLE_GRAPHRAG_API_BASE": "http://localhost:8000"
      }
    }
  }
}

Config file locations:

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

Restart Claude Desktop after saving the config.

Client Support¶

See MCP Tools for the full list of available tools.