MCP 服务器

Graphiti MCP Demo

Enables AI agents to build real-time knowledge graphs using Zep's Graphiti memory, persisting context in Neo4j.

README

<h1 align="center">Graphiti MCP Demo</h1> <h3 align="center">🚀 Build Real-Time Knowledge Graphs for AI Agents</h3>

</div>

📑 Table of Contents

About
Workflow
Setup
Running MCP Server
Integrating MCP Clients
Verifying in Neo4j
Final Output
Contribution
License

📖 About

We are implementing an MCP server and AI agent integration to leverage Zep's Graphiti for persistent memory and context continuity across Cursor and Claude.

This setup allows AI agents to:
✅ Connect to the MCP for dynamic tool discovery
✅ Select the optimal tool for a query
✅ Formulate responses with context continuity
✅ Persist interactions in Neo4j as a knowledge graph

🔄 Workflow of the Project

The workflow of this project shows how Cursor or Claude Desktop integrates with the MCP server and stores context in Graphiti memory (Neo4j):

Developer sends a Query from Cursor IDE or Claude Desktop.
The MCP Host connects to the MCP Server.
The MCP Server makes tool calls (e.g., add_episode, search_nodes, clear_graph) to interact with Graphiti memory.
Extracted context (documents, conversations, JSONs) is stored as structured data.
This data flows into different layers of the Graphiti Memory Structure:
- Level 1: Episodes → Raw data like documents, conversations, JSONs
- Level 2: Entities → Nodes & relationships extracted from episodes
- Level 3: Communities → Clusters of entities with summaries
The MCP Host sends the enriched context back to the developer as a response.

📽️ Workflow Demo

Workflow

⚙️ Setup

1️⃣ Clone GitHub Repository

git clone https://github.com/getzep/graphiti.git
cd graphiti/mcp_server

2️⃣ Install Dependencies

uv sync

3️⃣ Configure Environment

Create a .env file in graphiti/mcp_server:

# Neo4j Database Configuration
NEO4J_URI=bolt://localhost:7687
NEO4J_USER=neo4j
NEO4J_PASSWORD=demodemo

# OpenAI API Configuration
OPENAI_API_KEY=<your_openai_api_key>
MODEL_NAME=gpt-4.1-mini

🖥 Running MCP Server

Graphiti MCP server can be run using Docker or Python. Docker is recommended, but direct execution helps with troubleshooting.

▶️ Run with Docker

docker compose up

📸 Docker Container Running Docker Up

▶️ Run with Python (for debugging)

uv run graphiti_mcp_server.py --model gpt-4.1-mini --transport sse

📸 Graphiti SSE Output

🤝 Integrating MCP Clients

🔹 Cursor

Add this to your mcp.json:

{
  "mcpServers": {
    "Graphiti": {
      "url": "http://localhost:8000/sse"
    }
  }
}

🔹 Claude

Update claude_desktop_config.json:

{
  "mcpServers": {
    "graphiti": {
      "transport": "stdio",
      "command": "/path/to/uv",
      "args": [
        "run",
        "--isolated",
        "--directory",
        "/path/to/graphiti/mcp_server",
        "--project",
        ".",
        "graphiti_mcp_server.py",
        "--transport",
        "stdio"
      ]
    }
  }
}