Allows running the FalkorDB MCP server in a containerized environment with network configuration for connecting to FalkorDB instances.
Provides configuration management for the MCP server through environment variables stored in a .env file.
Supports repository cloning as part of the installation process for the FalkorDB MCP server.
Hosts the repository for the FalkorDB MCP server, enabling source code access and contribution through Pull Requests.
Provides the runtime environment for the FalkorDB MCP server, requiring v16 or later for operation.
Handles dependency management and provides script commands for building, running, and developing the FalkorDB MCP server.
Offers an alternative to npm for dependency management and package installation for the FalkorDB MCP server.
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:
- Install dependencies:
- Copy the example environment file and configure it: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:
Production
Build and start the server:
API Endpoints
GET /api/mcp/metadata
: Get metadata about the FalkorDB instance and available capabilitiesPOST /api/mcp/context
: Execute queries against FalkorDBGET /api/mcp/health
: Check server healthGET /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:
For client-side configuration:
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
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
- -securityFlicense-qualityFacilitates interaction and context sharing between AI models using the standardized Model Context Protocol (MCP) with features like interoperability, scalability, security, and flexibility across diverse AI systems.Last updated 7 months ago1Python
- AsecurityAlicenseAqualityA powerful Model Context Protocol (MCP) tool for exploring and managing different types of databases including PostgreSQL, MySQL, and Firestore.Last updated 5 months ago95TypeScriptMIT License
- AsecurityFlicenseAqualityImplements 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 3 months ago1125Python
- -securityAlicense-qualityA Model Context Protocol (MCP) server that enables AI assistants to interact with MySQL databases by executing SQL queries and checking database connectivity.Last updated 4 months agoTypeScriptMIT License