FalkorDB MCP Server

By FalkorDB GitHub

FalkorDB MCP Server

Overview

what is FalkorDB-MCPServer?

FalkorDB-MCPServer is a database server designed to provide efficient data management and retrieval capabilities.

how to use FalkorDB-MCPServer?

To use FalkorDB-MCPServer, set up the server by following the installation instructions on the GitHub repository, and connect your applications to it for data operations.

key features of FalkorDB-MCPServer?

High-performance data storage and retrieval
Support for various data types
Easy integration with applications via APIs

use cases of FalkorDB-MCPServer?

Managing large datasets for web applications
Providing backend support for mobile applications
Storing and retrieving user-generated content efficiently

FAQ from FalkorDB-MCPServer?

What kind of data can FalkorDB-MCPServer handle?

FalkorDB-MCPServer can handle various data types including structured and unstructured data.

Is FalkorDB-MCPServer open source?

Yes! FalkorDB-MCPServer is open source and available under the MIT license.

How can I contribute to FalkorDB-MCPServer?

You can contribute by submitting issues, feature requests, or pull requests on the GitHub repository.

Content

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.

No tools information available.

No content found.