FalkorDB

FalkorDB

FalkorDB graph database server get schema and read/write-cypher FalkorDB

22
Stars
10
Forks
1
Releases

Overview

FalkorDB MCP Server implements the Model Context Protocol (MCP) to connect AI models with FalkorDB graph databases. It translates and routes MCP requests from AI agents to FalkorDB and formats the responses according to the MCP standard. The server exposes a set of API endpoints to expose capabilities and interact with FalkorDB: GET /api/mcp/metadata for metadata about the FalkorDB instance and its capabilities, POST /api/mcp/context to execute context queries against FalkorDB, GET /api/mcp/health to check server health, and GET /api/mcp/graphs to list available graphs. Configuration is managed via environment variables in a .env file, including PORT, NODE_ENV, FALKORDB_HOST, FALKORDB_PORT, FALKORDB_USERNAME, FALKORDB_PASSWORD, and MCP_API_KEY for authenticating MCP requests. Prerequisites include Node.js (v16+), npm or yarn, and a FalkorDB instance. Development supports hot-reloading with npm run dev, while production uses npm run build followed by npm start. The README also provides a Docker-based MCP configuration example showing how to run the server and expose the MCP API endpoint.

Details

Owner
FalkorDB
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

MCP gateway to FalkorDB

Serves as an MCP-compliant gateway that connects AI models to FalkorDB and routes MCP requests to the database.

MCP request translation and response formatting

Translates MCP requests into FalkorDB queries and formats results per MCP specifications.

API endpoints for MCP operations

Provides endpoints for metadata, context execution, health checks, and graph listing.

Environment-based configuration

Configurable via a .env file with settings for port, host, credentials, and MCP API key.

Development workflow with hot-reload

Supports development with hot-reloading via npm run dev.

Production deployment workflow

Supports building and starting for production using npm run build and npm start.

Docker-based deployment example

Includes an example MCP configuration showing how to run via Docker.

Secure MCP access

Uses MCP_API_KEY to authenticate MCP requests.

Audience

AI model developersUse MCP clients to issue queries to FalkorDB via the FalkorDB MCP Server.

Tags

FalkorDBMCPModel Context ProtocolGraph DatabaseNode.jsAPIAI integration