Home / MCP / FalkorDB MCP Server

FalkorDB MCP Server

Provides MCP-based access to FalkorDB graphs for model-driven querying and management.

javascript

23stars

View on GitHub

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
    "mcpServers": {
        "falkordb": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-p",
                "3000:3000",
                "--env-file",
                ".env",
                "falkordb-mcpserver",
                "falkordb://host.docker.internal:6379"
            ]
        }
    }
}

You run a FalkorDB MCP Server to let AI models query and interact with FalkorDB graph databases. This server translates MCP requests to FalkorDB and formats responses back to MCP clients, enabling seamless model-driven graph operations.

How to use

You connect your MCP client to the FalkorDB MCP Server to run context queries against FalkorDB graphs. The server exposes a small HTTP API for management and a context endpoint for executing MCP queries. Typical flows include retrieving metadata about the FalkorDB instance and capabilities, sending a context request to execute graph queries, and checking the server’s health. For production usage, you will configure a persistent MCP client to route requests to the server and manage authentication with an API key.

How to install

Prerequisites you need before installation are Node.js version 16 or later, a package manager (npm or yarn), and a FalkorDB instance (local or remote). Ensure Node.js is available on your system before proceeding.

Step 1: Install the MCP server dependencies by cloning the project and installing packages.

# Step 1: Clone the MCP server repository
git clone https://github.com/falkordb/falkordb-mcpserver.git
cd falkordb-mcpserver

# Step 2: Install dependencies
npm install

How to configure and run the server

Configure the server by creating and editing the environment configuration. You will provide connection details for FalkorDB and an API key for MCP request authentication. The setup uses an environment file named .env with the necessary values.

# Step 3: Copy and configure the environment file
cp .env.example .env
```

Edit `.env` to set your FalkorDB host/port, authentication, and MCP API key.

Access and management endpoints

The server exposes a set of endpoints to manage MCP interactions and monitor health. You can retrieve metadata about FalkorDB capabilities, execute MCP context queries, and verify the server is healthy.

MCP server execution example

# Start in development mode with hot-reloading (example)
npm run dev

# Build for production and start
npm run build
npm start

Monitoring and graphs

You can request the list of graphs and monitor server health via the provided endpoints. Use the health endpoint to verify the server is running and reachable, and the graphs endpoint to inspect available FalkorDB graphs.

Available tools

getMetadata

Fetches metadata about the FalkorDB instance and its MCP capabilities.

executeContext

Sends an MCP context query to FalkorDB and returns results formatted per MCP specifications.

checkHealth

Checks the server health status to ensure MCP interactions are functioning.

listGraphs

Retrieves the list of available Graphs from FalkorDB.