From e311dab6176cca29923306ef1e52521933241ecd Mon Sep 17 00:00:00 2001
From: Daniel Chalef <131175+danielchalef@users.noreply.github.com>
Date: Wed, 21 May 2025 18:55:13 -0700
Subject: [PATCH] Update README for Graphiti MCP server configuration and
 integration with Claude Desktop

- Changed server name from "graphiti" to "graphiti-memory" in configuration examples for clarity.
- Added instructions for running the Graphiti MCP server using Docker.
- Included detailed steps for integrating Claude Desktop with the Graphiti MCP server, including optional installation of `mcp-remote`.
- Enhanced overall documentation to improve user experience and understanding of the setup process.
---
 mcp_server/README.md | 53 ++++++++++++++++++++++++++++++++++++++++----
 1 file changed, 49 insertions(+), 4 deletions(-)

diff --git a/mcp_server/README.md b/mcp_server/README.md
index 0de91236..f1724fde 100644
--- a/mcp_server/README.md
+++ b/mcp_server/README.md
@@ -183,7 +183,7 @@ To use the Graphiti MCP server with an MCP-compatible client, configure it to co
 ```json
 {
   "mcpServers": {
-    "graphiti": {
+    "graphiti-memory": {
       "transport": "stdio",
       "command": "/Users/<user>/.local/bin/uv",
       "args": [
@@ -214,7 +214,7 @@ For SSE transport (HTTP-based), you can use this configuration:
 ```json
 {
   "mcpServers": {
-    "graphiti": {
+    "graphiti-memory": {
       "transport": "sse",
       "url": "http://localhost:8000/sse"
     }
@@ -264,12 +264,18 @@ python graphiti_mcp_server.py --transport sse --use-custom-entities --group-id <
 
 Hint: specify a `group_id` to namespace graph data. If you do not specify a `group_id`, the server will use "default" as the group_id.
 
+or
+
+```bash
+docker compose up
+```
+
 2. Configure Cursor to connect to the Graphiti MCP server.
 
 ```json
 {
   "mcpServers": {
-    "Graphiti": {
+    "graphiti-memory": {
       "url": "http://localhost:8000/sse"
     }
   }
@@ -283,6 +289,45 @@ Hint: specify a `group_id` to namespace graph data. If you do not specify a `gro
 The integration enables AI assistants in Cursor to maintain persistent memory through Graphiti's knowledge graph
 capabilities.
 
+## Integrating with Claude Desktop (Docker MCP Server)
+
+The Graphiti MCP Server container uses the SSE MCP transport. Claude Desktop does not natively support SSE, so you'll need to use a gateway like `mcp-remote`.
+
+1.  **Run the Graphiti MCP server using SSE transport**:
+
+    ```bash
+    docker compose up
+    ```
+
+2.  **(Optional) Install `mcp-remote` globally**:
+    If you prefer to have `mcp-remote` installed globally, or if you encounter issues with `npx` fetching the package, you can install it globally. Otherwise, `npx` (used in the next step) will handle it for you.
+
+    ```bash
+    npm install -g mcp-remote
+    ```
+
+3.  **Configure Claude Desktop**:
+    Open your Claude Desktop configuration file (usually `claude_desktop_config.json`) and add or modify the `mcpServers` section as follows:
+
+    ```json
+    {
+      "mcpServers": {
+        "graphiti-memory": {
+          // You can choose a different name if you prefer
+          "command": "npx", // Or the full path to mcp-remote if npx is not in your PATH
+          "args": [
+            "mcp-remote",
+            "http://localhost:8000/sse" // Ensure this matches your Graphiti server's SSE endpoint
+          ]
+        }
+      }
+    }
+    ```
+
+    If you already have an `mcpServers` entry, add `graphiti-memory` (or your chosen name) as a new key within it.
+
+4.  **Restart Claude Desktop** for the changes to take effect.
+
 ## Requirements
 
 - Python 3.10 or higher
@@ -292,4 +337,4 @@ capabilities.
 
 ## License
 
-This project is licensed under the same license as the Graphiti project.
+This project is licensed under the same license as the parent Graphiti project.