https://github.com/FalkorDB/falkordb-mcpserver
FalkorDB MCP Server
https://github.com/FalkorDB/falkordb-mcpserver
Last synced: 9 months ago
JSON representation
FalkorDB MCP Server
- Host: GitHub
- URL: https://github.com/FalkorDB/falkordb-mcpserver
- Owner: FalkorDB
- License: mit
- Created: 2025-03-30T20:15:47.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-31T16:43:38.000Z (about 1 year ago)
- Last Synced: 2025-06-17T13:12:51.178Z (10 months ago)
- Language: TypeScript
- Size: 123 KB
- Stars: 10
- Watchers: 3
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - Falkordb MCP Server - Allows AI models to query and interact with FalkorDB graph databases through the Model Context Protocol (MCP) specification. Enables natural language queries and analysis of knowledge graphs and recommendation systems via MCP. ([Read more](/details/falkordb-mcp-server.md)) `falkordb` `graph-database` `ai-integration` `mcp` (Database & Messaging MCP Servers)
README
# 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:
```bash
git clone https://github.com/falkordb/falkordb-mcpserver.git
cd falkordb-mcpserver
```
2. Install dependencies:
```bash
npm install
```
3. Copy the example environment file and configure it:
```bash
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:
```bash
npm run dev
```
### Production
Build and start the server:
```bash
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:
```json
{
"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:
```json
{
"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](LICENSE) file for details.