FalkorDB MCP Server

A Model Context Protocol (MCP) server for FalkorDB, allowing AI models to query and interact with graph databases. FalkorDB MCP Server enables AI assistants like Claude to interact with FalkorDB graph databases using natural language. Query your graph data, create relationships, and manage your knowledge graph - all through conversational AI.

🎯 What is this?

This server implements the Model Context Protocol (MCP), allowing AI models to:

• Query graph databases using OpenCypher (with read-only mode support)
• Create and manage nodes and relationships
• List and explore multiple graphs
• Delete graphs when needed
• Read-only queries for replica instances or to prevent accidental writes

🚀 Quick Start

Prerequisites

• Node.js 18+
• FalkorDB instance (running locally or remotely)
• Claude Desktop app (for AI integration)

Running from npm

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "falkordb": {
      "command": "npx",
      "args": [
        "-y",
        "@falkordb/mcpserver@latest"
      ],
      "env": {
        "FALKORDB_HOST": "localhost",
        "FALKORDB_PORT": "6379",
        "FALKORDB_USERNAME": "",
        "FALKORDB_PASSWORD": ""
      }
    }
  }
}

Running with npx

You can run the server directly from the command line using npx:

Using inline environment variables:

# Run with stdio transport (default)
FALKORDB_HOST=localhost FALKORDB_PORT=6379 npx -y @falkordb/mcpserver

# Run with HTTP transport
MCP_TRANSPORT=http MCP_PORT=3005 FALKORDB_HOST=localhost FALKORDB_PORT=6379 npx -y @falkordb/mcpserver

Using a .env file:

# Using dotenv-cli to load environment variables from .env
npx dotenv-cli -e .env -- npx @falkordb/mcpserver

This is useful for:

• Quick testing and development
• Running the server standalone without Claude Desktop
• Custom integrations and scripting

Docker Compose

Run FalkorDB and the MCP server together:

cp .env.example .env   # create env file; edit to set MCP_API_KEY, FALKORDB_PASSWORD, etc.
docker compose up -d

Note: Skipping the .env file leaves variables like MCP_API_KEY and FALKORDB_PASSWORD empty, which disables API key authentication and uses no database password.

This starts FalkorDB with health checks and persistent volumes, plus the MCP server pre-configured to connect to it.

The MCP server runs in HTTP transport mode and is exposed on localhost:3000 by default. To connect a client, configure it to use:

• Transport: http
• URL: http://localhost:3000
• API Key: Set via the MCP_API_KEY environment variable (optional)

See docker-compose.yml for the exact port and configuration values.

Installation

1. Clone and install:

   git clone https://github.com/FalkorDB/Fal
   

... View full README on GitHub