Skip to main content
Glama

FalkorDB MCP Server

Official
by FalkorDB

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

  1. Clone this repository:
    git clone https://github.com/falkordb/falkordb-mcpserver.git cd falkordb-mcpserver
  2. Install dependencies:
    npm install
  3. 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.

-
security - not tested
A
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.

  1. Overview
    1. Prerequisites
      1. Installation
        1. Configuration
          1. Usage
            1. Development
            2. Production
          2. API Endpoints
            1. MCP Configuration
              1. Contributing
                1. License

                  Related MCP Servers

                  • -
                    security
                    F
                    license
                    -
                    quality
                    Facilitates 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 ago
                    1
                    Python
                  • A
                    security
                    A
                    license
                    A
                    quality
                    A powerful Model Context Protocol (MCP) tool for exploring and managing different types of databases including PostgreSQL, MySQL, and Firestore.
                    Last updated 5 months ago
                    9
                    5
                    TypeScript
                    MIT License
                  • A
                    security
                    F
                    license
                    A
                    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 3 months ago
                    1
                    125
                    Python
                    • Apple
                    • Linux
                  • -
                    security
                    A
                    license
                    -
                    quality
                    A 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 ago
                    TypeScript
                    MIT License
                    • Apple
                    • Linux

                  View all related MCP servers

                  MCP directory API

                  We provide all the information about MCP servers via our MCP API.

                  curl -X GET 'https://glama.ai/api/mcp/v1/servers/FalkorDB/FalkorDB-MCPServer'

                  If you have feedback or need assistance with the MCP directory API, please join our Discord server