Happy slice of mcp pizzaMCP.pizza

graphiti-mcp-server

MCP.Pizza Chef: gifflet

Assistants normally start fresh every conversation. This gives one a memory that persists: facts you mention get stored as connected pieces rather than a flat pile, so later questions can draw on what came before and on how things relate. It runs against a graph database you host, works in Cursor, and needs an OpenAI key for the part that pulls facts out of text. Setup involves Docker, so it is a developer job.

Unmaintained · No commits in 12 months.
Data
Notes
Web/Research

Use This MCP server To

Have my assistant remember facts between chats Ask what it already knows about a project Build up notes on people and companies over time Connect related facts instead of storing a list Search everything my assistant has learned

README

Graphiti MCP Server 🧠

Python Version License Docker

🌟 A powerful knowledge graph server for AI agents, built with Neo4j and integrated with Model Context Protocol (MCP).

🚀 Features

  • 🔄 Dynamic knowledge graph management with Neo4j
  • 🤖 Seamless integration with OpenAI models
  • 🔌 MCP (Model Context Protocol) support
  • 🐳 Docker-ready deployment
  • 🎯 Custom entity extraction capabilities
  • 🔍 Advanced semantic search functionality

🛠️ Installation

Prerequisites

  • Docker and Docker Compose
  • Python 3.10 or higher
  • OpenAI API key

Quick Start 🚀

  1. Clone the repository:
git clone https://github.com/gifflet/graphiti-mcp-server.git
cd graphiti-mcp-server
  1. Set up environment variables:
cp .env.sample .env
  1. Edit .env with your configuration:
# Required for LLM operations
OPENAI_API_KEY=your_openai_api_key_here
MODEL_NAME=gpt-4o
  1. Start the services:
docker compose up

🔧 Configuration

Neo4j Settings 🗄️

Default configuration for Neo4j:

  • Username: neo4j
  • Password: demodemo
  • URI: bolt://neo4j:7687 (within Docker network)
  • Memory settings optimized for development

Docker Environment Variables 🐳

You can run with environment variables directly:

OPENAI_API_KEY=your_key MODEL_NAME=gpt-4o docker compose up

🔌 Integration

Cursor IDE Integration 🖥️

  1. Configure Cursor to connect to Graphiti:
{
  "mcpServers": {
    "Graphiti": {
      "url": "http://localhost:8000/sse"
    }
  }
}
  1. Add Graphiti rules to Cursor's User Rules (see graphiti_cursor_rules.md)
  2. Start an agent session in Cursor

🏗️ Architecture

The server consists of two main components:

  • Neo4j database for graph storage
  • Graphiti MCP server for API and LLM operations

🤝 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.

🙏 Acknowledgments

  • Neo4j team for the amazing graph database
  • OpenAI for their powerful LLM models
  • MCP community for the protocol specification

graphiti-mcp-server FAQ

Can I use this to make my assistant remember things?
Yes — facts persist between conversations rather than resetting each session.
Do I need an account or key?
Yes, an OpenAI key is required for the part that extracts facts from what you write.
Where is my information stored?
In a Neo4j graph database you run yourself, so it stays on infrastructure you control.
Which apps does it work with?
It is documented for Cursor and works with other assistants supporting this connection.
How hard is it to set up?
You need Docker and a recent Python, so this is a developer setup rather than a quick install.