From 027035a2412effd574c3a2e0d6878becf9f0aaae Mon Sep 17 00:00:00 2001 From: Daniel Chalef <131175+danielchalef@users.noreply.github.com> Date: Tue, 1 Jul 2025 16:14:41 -0700 Subject: [PATCH] feat: add pre-built Docker image for Graphiti MCP server (#657) * Update Docker Compose to use the latest Graphiti MCP image and enhance README documentation * Enhance README.md with updated quick start instructions for various clients, including specific sections for Claude Desktop and Cursor, and clarify service startup steps using Docker Compose. --- mcp_server/README.md | 22 +++++++++++++++++++--- mcp_server/docker-compose.yml | 1 + 2 files changed, 20 insertions(+), 3 deletions(-) diff --git a/mcp_server/README.md b/mcp_server/README.md index 501fc6fa..d957feb8 100644 --- a/mcp_server/README.md +++ b/mcp_server/README.md @@ -21,9 +21,9 @@ The Graphiti MCP server exposes the following key high-level functions of Graphi - **Group Management**: Organize and manage groups of related data with group_id filtering - **Graph Maintenance**: Clear the graph and rebuild indices -## Quick Start for Claude Desktop, Cursor, and other clients +## Quick Start -1. Clone the Graphiti GitHub repo +### Clone the Graphiti GitHub repo ```bash git clone https://github.com/getzep/graphiti.git @@ -35,7 +35,9 @@ or gh repo clone getzep/graphiti ``` -Note the full path to this directory. +### For Claude Desktop and other `stdio` only clients + +1. Note the full path to this directory. ``` cd graphiti && pwd @@ -45,6 +47,18 @@ cd graphiti && pwd 3. Configure Claude, Cursor, or other MCP client to use [Graphiti with a `stdio` transport](#integrating-with-mcp-clients). See the client documentation on where to find their MCP configuration files. +### For Cursor and other `sse`-enabled clients + +1. Change directory to the `mcp_server` directory + +`cd graphiti/mcp_server` + +2. Start the service using Docker Compose + +`docker compose up` + +3. Point your MCP client to `http://localhost:8000/sse` + ## Installation ### Prerequisites @@ -163,6 +177,8 @@ The Docker Compose setup includes a Neo4j container with the following default c #### Running with Docker Compose +A Graphiti MCP container is available at: `zepai/knowledge-graph-mcp`. The latest build of this container is used by the Compose setup below. + Start the services using Docker Compose: ```bash diff --git a/mcp_server/docker-compose.yml b/mcp_server/docker-compose.yml index 6a4ba16f..13b64dae 100644 --- a/mcp_server/docker-compose.yml +++ b/mcp_server/docker-compose.yml @@ -20,6 +20,7 @@ services: start_period: 30s graphiti-mcp: + image: zepai/knowledge-graph-mcp:latest build: context: . dockerfile: Dockerfile