falkordb/graphiti-knowledge-graph-mcp repository overview

⁠Graphiti MCP Server

Graphiti is a framework for building and querying temporally-aware knowledge graphs, specifically tailored for AI agents operating in dynamic environments. Unlike traditional retrieval-augmented generation (RAG) methods, Graphiti continuously integrates user interactions, structured and unstructured enterprise data, and external information into a coherent, queryable graph. The framework supports incremental data updates, efficient retrieval, and precise historical queries without requiring complete graph recomputation, making it suitable for developing interactive, context-aware AI applications.

This is an experimental Model Context Protocol (MCP) server implementation for Graphiti. The MCP server exposes Graphiti's key functionality through the MCP protocol, allowing AI assistants to interact with Graphiti's knowledge graph capabilities.

⁠Features

The Graphiti MCP server exposes the following key high-level functions of Graphiti:

• Episode Management: Add, retrieve, and delete episodes (text, messages, or JSON data)
• Entity Management: Search and manage entity nodes and relationships in the knowledge graph
• Search Capabilities: Search for facts (edges) and node summaries using semantic and hybrid search
• Group Management: Organize and manage groups of related data with group_id filtering
• Graph Maintenance: Clear the graph and rebuild indices

⁠Run FalkorDB

docker network create mcp-graphiti
docker run -p 6379:6379 -p 3000:3000 --name falkordb --network mcp-graphiti  --pull=always -it --rm falkordb/falkordb

⁠MCP Server configuration

Create .env file

DATABASE_TYPE=falkordb
FALKORDB_PORT=6379
FALKORDB_HOST=falkordb
FALKORDB_USER=
FALKORDB_PASSWORD=
OPENAI_API_KEY=[openai-key]
MODEL_NAME=gpt-5

GRAPHITI_TELEMETRY_ENABLED=false

⁠Start Graphiti MCP sever

docker run --env-file .env --network mcp-graphiti -p 8000:8000 -it falkordb/graphiti-knowledge-graph-mcp