FalkorDB MCP Server

A Model Context Protocol (MCP) server for FalkorDB, allowing AI models to query and interact with graph databases.

Overview

This project implements a server that follows the Model Context Protocol (MCP) specification to connect AI models with FalkorDB graph databases. The server translates and routes MCP requests to FalkorDB and formats the responses according to the MCP standard.

Prerequisites

Node.js (v16 or later)
npm or yarn
FalkorDB instance (can be run locally or remotely)

Installation

Clone this repository:
git clone https://github.com/falkordb/falkordb-mcpserver.git cd falkordb-mcpserver
Install dependencies:
npm install
Copy the example environment file and configure it:
cp .env.example .env
Edit .env with your configuration details.

Configuration

Configuration is managed through environment variables in the .env file:

PORT: Server port (default: 3000)
NODE_ENV: Environment (development, production)
FALKORDB_HOST: FalkorDB host (default: localhost)
FALKORDB_PORT: FalkorDB port (default: 6379)
FALKORDB_USERNAME: Username for FalkorDB authentication (if required)
FALKORDB_PASSWORD: Password for FalkorDB authentication (if required)
MCP_API_KEY: API key for authenticating MCP requests

Usage

Development

Start the development server with hot-reloading:

npm run dev

Production

Build and start the server:

npm run build
npm start

API Endpoints

GET /api/mcp/metadata: Get metadata about the FalkorDB instance and available capabilities
POST /api/mcp/context: Execute queries against FalkorDB
GET /api/mcp/health: Check server health
GET /api/mcp/graphs: Returns the list of Graphs

MCP Configuration

To use this server with MCP clients, you can add it to your MCP configuration:

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

For client-side configuration:

{
  "defaultServer": "falkordb",
  "servers": {
    "falkordb": {
      "url": "http://localhost:3000/api/mcp",
      "apiKey": "your_api_key_here"
    }
  }
}

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Allows AI models to query and interact with FalkorDB graph databases through the Model Context Protocol (MCP) specification.

Related MCP Servers

Logseq MCP Tools
joelhooks
-
security
F
license
-
quality
A Model Context Protocol server that provides AI assistants with structured access to your Logseq knowledge graph, enabling retrieval, searching, analysis, and creation of content within your personal knowledge base.
Last updated -
19
TypeScript
MCP Server
GobinFan
-
security
F
license
-
quality
Implements the Model Context Protocol (MCP) to provide AI models with a standardized interface for connecting to external data sources and tools like file systems, databases, or APIs.
Last updated -
90
Python
Advanced Hasura GraphQL MCP Server
husamabusafa
-
security
-
license
-
quality
A Model Context Protocol server that enables AI agents to dynamically interact with Hasura GraphQL endpoints through natural language, supporting schema discovery, data querying/manipulation, and aggregations.
Last updated -
1
TypeScript
Ontology MCP
bigdata-coss
A
security
A
license
A
quality
A Model Context Protocol (MCP) server that connects GraphDB's SPARQL endpoints and Ollama models to Claude, enabling Claude to query and manipulate ontology data while leveraging various AI models.
Last updated -
28
1
TypeScript
MIT License

View all related MCP servers

FalkorDB MCP Server