graphiti-core 0.15.0__tar.gz → 0.15.1__tar.gz

graphiti_core-0.15.1/.github/workflows/mcp-server-docker.yml

@@ -0,0 +1,73 @@
+name: Build and Push MCP Server Docker Image
+
+on:
+  push:
+    paths:
+      - "mcp_server/pyproject.toml"
+    branches:
+      - main
+  pull_request:
+    paths:
+      - "mcp_server/pyproject.toml"
+    branches:
+      - main
+  workflow_dispatch:
+    inputs:
+      push_image:
+        description: "Push image to registry (unchecked for testing)"
+        required: false
+        default: false
+        type: boolean
+
+env:
+  REGISTRY: docker.io
+  IMAGE_NAME: zepai/knowledge-graph-mcp
+
+jobs:
+  build-and-push:
+    runs-on: depot-ubuntu-24.04-small
+    environment: development
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Extract version from pyproject.toml
+        id: version
+        run: |
+          VERSION=$(python -c "import tomllib; print(tomllib.load(open('mcp_server/pyproject.toml', 'rb'))['project']['version'])")
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          echo "tag=v$VERSION" >> $GITHUB_OUTPUT
+      - name: Log in to Docker Hub
+        if: github.event_name != 'pull_request' && (github.event_name != 'workflow_dispatch' || inputs.push_image)
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+
+      - name: Set up Depot CLI
+        uses: depot/setup-action@v1
+
+      - name: Extract metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=ref,event=branch
+            type=ref,event=pr
+            type=raw,value=${{ steps.version.outputs.tag }}
+            type=raw,value=latest,enable={{is_default_branch}}
+
+      - name: Depot build and push image
+        uses: depot/build-push-action@v1
+        with:
+          project: v9jv1mlpwc
+          context: ./mcp_server
+          platforms: linux/amd64,linux/arm64
+          push: ${{ github.event_name != 'pull_request' && (github.event_name != 'workflow_dispatch' || inputs.push_image) }}
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}

{graphiti_core-0.15.0 → graphiti_core-0.15.1}/CONTRIBUTING.md

@@ -116,7 +116,7 @@ Once you've found an issue tagged with "good first issue" or "help wanted," or p
 We use several tools to maintain code quality:
 
 - Ruff for linting and formatting
-- Mypy for static type checking
+- Pyright for static type checking
 - Pytest for testing
 
 Before submitting a pull request, please run:
@@ -127,6 +127,67 @@ make check
 
 This command will format your code, run linting checks, and execute tests.
 
+## Third-Party Integrations
+
+When contributing integrations for third-party services (LLM providers, embedding services, databases, etc.), please follow these patterns:
+
+### Optional Dependencies
+
+All third-party integrations must be optional dependencies to keep the core library lightweight. Follow this pattern:
+
+1. **Add to `pyproject.toml`**: Define your dependency as an optional extra AND include it in the dev extra:
+   ```toml
+   [project.optional-dependencies]
+   your-service = ["your-package>=1.0.0"]
+   dev = [
+       # ... existing dev dependencies
+       "your-package>=1.0.0",  # Include all optional extras here
+       # ... other dependencies
+   ]
+   ```
+
+2. **Use TYPE_CHECKING pattern**: In your integration module, import dependencies conditionally:
+   ```python
+   from typing import TYPE_CHECKING
+   
+   if TYPE_CHECKING:
+       import your_package
+       from your_package import SomeType
+   else:
+       try:
+           import your_package
+           from your_package import SomeType
+       except ImportError:
+           raise ImportError(
+               'your-package is required for YourServiceClient. '
+               'Install it with: pip install graphiti-core[your-service]'
+           ) from None
+   ```
+
+3. **Benefits of this pattern**:
+   - Fast startup times (no import overhead during type checking)
+   - Clear error messages with installation instructions
+   - Proper type hints for development
+   - Consistent user experience
+
+4. **Do NOT**:
+   - Add optional imports to `__init__.py` files
+   - Use direct imports without error handling
+   - Include optional dependencies in the main `dependencies` list
+
+### Integration Structure
+
+- Place LLM clients in `graphiti_core/llm_client/`
+- Place embedding clients in `graphiti_core/embedder/`
+- Place database drivers in `graphiti_core/driver/`
+- Follow existing naming conventions (e.g., `your_service_client.py`)
+
+### Testing
+
+- Add comprehensive tests in the appropriate `tests/` subdirectory
+- Mark integration tests with `_int` suffix if they require external services
+- Include both unit tests and integration tests where applicable
+
 # Questions?
 
 Stuck on a contribution or have a half-formed idea? Come say hello in our [Discord server](https://discord.com/invite/W8Kw6bsgXQ). Whether you're ready to contribute or just want to learn more, we're happy to have you! It's faster than GitHub issues and you'll find both maintainers and fellow contributors ready to help.

{graphiti_core-0.15.0 → graphiti_core-0.15.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: graphiti-core
-Version: 0.15.0
+Version: 0.15.1
 Summary: A temporal graph building library
 Project-URL: Homepage, https://help.getzep.com/graphiti/graphiti/overview
 Project-URL: Repository, https://github.com/getzep/graphiti
@@ -21,6 +21,7 @@ Requires-Dist: anthropic>=0.49.0; extra == 'anthropic'
 Provides-Extra: dev
 Requires-Dist: anthropic>=0.49.0; extra == 'dev'
 Requires-Dist: diskcache-stubs>=5.6.3.6.20240818; extra == 'dev'
+Requires-Dist: falkordb<2.0.0,>=1.1.2; extra == 'dev'
 Requires-Dist: google-genai>=1.8.0; extra == 'dev'
 Requires-Dist: groq>=0.2.0; extra == 'dev'
 Requires-Dist: ipykernel>=6.29.5; extra == 'dev'
@@ -37,12 +38,16 @@ Requires-Dist: ruff>=0.7.1; extra == 'dev'
 Requires-Dist: sentence-transformers>=3.2.1; extra == 'dev'
 Requires-Dist: transformers>=4.45.2; extra == 'dev'
 Requires-Dist: voyageai>=0.2.3; extra == 'dev'
-Provides-Extra: falkord-db
-Requires-Dist: falkordb<2.0.0,>=1.1.2; extra == 'falkord-db'
+Provides-Extra: falkordb
+Requires-Dist: falkordb<2.0.0,>=1.1.2; extra == 'falkordb'
 Provides-Extra: google-genai
 Requires-Dist: google-genai>=1.8.0; extra == 'google-genai'
 Provides-Extra: groq
 Requires-Dist: groq>=0.2.0; extra == 'groq'
+Provides-Extra: sentence-transformers
+Requires-Dist: sentence-transformers>=3.2.1; extra == 'sentence-transformers'
+Provides-Extra: voyageai
+Requires-Dist: voyageai>=0.2.3; extra == 'voyageai'
 Description-Content-Type: text/markdown
 
 <p align="center">
@@ -184,7 +189,18 @@ or
 uv add graphiti-core
 ```
 
-You can also install optional LLM providers as extras:
+### Installing with FalkorDB Support
+
+If you plan to use FalkorDB as your graph database backend, install with the FalkorDB extra:
+
+```bash
+pip install graphiti-core[falkordb]
+
+# or with uv
+uv add graphiti-core[falkordb]
+```
+
+### You can also install optional LLM providers as extras:
 
 ```bash
 # Install with Anthropic support
@@ -198,6 +214,9 @@ pip install graphiti-core[google-genai]
 
 # Install with multiple providers
 pip install graphiti-core[anthropic,groq,google-genai]
+
+# Install with FalkorDB and LLM providers
+pip install graphiti-core[falkordb,anthropic,google-genai]
 ```
 
 ## Quick Start

{graphiti_core-0.15.0 → graphiti_core-0.15.1}/README.md

@@ -137,7 +137,18 @@ or
 uv add graphiti-core
 ```
 
-You can also install optional LLM providers as extras:
+### Installing with FalkorDB Support
+
+If you plan to use FalkorDB as your graph database backend, install with the FalkorDB extra:
+
+```bash
+pip install graphiti-core[falkordb]
+
+# or with uv
+uv add graphiti-core[falkordb]
+```
+
+### You can also install optional LLM providers as extras:
 
 ```bash
 # Install with Anthropic support
@@ -151,6 +162,9 @@ pip install graphiti-core[google-genai]
 
 # Install with multiple providers
 pip install graphiti-core[anthropic,groq,google-genai]
+
+# Install with FalkorDB and LLM providers
+pip install graphiti-core[falkordb,anthropic,google-genai]
 ```
 
 ## Quick Start

{graphiti_core-0.15.0 → graphiti_core-0.15.1}/examples/quickstart/quickstart_falkordb.py

@@ -49,7 +49,7 @@ load_dotenv()
 # Make sure FalkorDB (on-premises) is running — see https://docs.falkordb.com/
 # By default, FalkorDB does not require a username or password,
 # but you can set them via environment variables for added security.
-# 
+#
 # If you're using FalkorDB Cloud, set the environment variables accordingly.
 # For on-premises use, you can leave them as None or set them to your preferred values.
 #
@@ -61,6 +61,7 @@ falkor_password = os.environ.get('FALKORDB_PASSWORD', None)
 falkor_host = os.environ.get('FALKORDB_HOST', 'localhost')
 falkor_port = os.environ.get('FALKORDB_PORT', '6379')
 
+
 async def main():
     #################################################
     # INITIALIZATION
@@ -71,7 +72,9 @@ async def main():
     #################################################
 
     # Initialize Graphiti with FalkorDB connection
-    falkor_driver = FalkorDriver(host=falkor_host, port=falkor_port, username=falkor_username, password=falkor_password)
+    falkor_driver = FalkorDriver(
+        host=falkor_host, port=falkor_port, username=falkor_username, password=falkor_password
+    )
     graphiti = Graphiti(graph_driver=falkor_driver)
 
     try:

{graphiti_core-0.15.0 → graphiti_core-0.15.1}/graphiti_core/cross_encoder/__init__.py

@@ -15,7 +15,6 @@ limitations under the License.
 """
 
 from .client import CrossEncoderClient
-from .gemini_reranker_client import GeminiRerankerClient
 from .openai_reranker_client import OpenAIRerankerClient
 
-__all__ = ['CrossEncoderClient', 'GeminiRerankerClient', 'OpenAIRerankerClient']
+__all__ = ['CrossEncoderClient', 'OpenAIRerankerClient']

{graphiti_core-0.15.0 → graphiti_core-0.15.1}/graphiti_core/cross_encoder/bge_reranker_client.py

@@ -15,8 +15,18 @@ limitations under the License.
 """
 
 import asyncio
-
-from sentence_transformers import CrossEncoder
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from sentence_transformers import CrossEncoder
+else:
+    try:
+        from sentence_transformers import CrossEncoder
+    except ImportError:
+        raise ImportError(
+            'sentence-transformers is required for BGERerankerClient. '
+            'Install it with: pip install graphiti-core[sentence-transformers]'
+        ) from None
 
 from graphiti_core.cross_encoder.client import CrossEncoderClient
 

{graphiti_core-0.15.0 → graphiti_core-0.15.1}/graphiti_core/cross_encoder/gemini_reranker_client.py

@@ -16,14 +16,25 @@ limitations under the License.
 
 import logging
 import re
-
-from google import genai  # type: ignore
-from google.genai import types  # type: ignore
+from typing import TYPE_CHECKING
 
 from ..helpers import semaphore_gather
 from ..llm_client import LLMConfig, RateLimitError
 from .client import CrossEncoderClient
 
+if TYPE_CHECKING:
+    from google import genai
+    from google.genai import types
+else:
+    try:
+        from google import genai
+        from google.genai import types
+    except ImportError:
+        raise ImportError(
+            'google-genai is required for GeminiRerankerClient. '
+            'Install it with: pip install graphiti-core[google-genai]'
+        ) from None
+
 logger = logging.getLogger(__name__)
 
 DEFAULT_MODEL = 'gemini-2.5-flash-lite-preview-06-17'
@@ -33,7 +44,7 @@ class GeminiRerankerClient(CrossEncoderClient):
     def __init__(
         self,
         config: LLMConfig | None = None,
-        client: genai.Client | None = None,
+        client: 'genai.Client | None' = None,
     ):
         """
         Initialize the GeminiRerankerClient with the provided configuration and client.
@@ -46,6 +57,7 @@ class GeminiRerankerClient(CrossEncoderClient):
             config (LLMConfig | None): The configuration for the LLM client, including API key, model, base URL, temperature, and max tokens.
             client (genai.Client | None): An optional async client instance to use. If not provided, a new genai.Client is created.
         """
+
         if config is None:
             config = LLMConfig()
 

{graphiti_core-0.15.0 → graphiti_core-0.15.1}/graphiti_core/cross_encoder/openai_reranker_client.py

@@ -22,7 +22,7 @@ import openai
 from openai import AsyncAzureOpenAI, AsyncOpenAI
 
 from ..helpers import semaphore_gather
-from ..llm_client import LLMConfig, RateLimitError
+from ..llm_client import LLMConfig, OpenAIClient, RateLimitError
 from ..prompts import Message
 from .client import CrossEncoderClient
 
@@ -35,7 +35,7 @@ class OpenAIRerankerClient(CrossEncoderClient):
     def __init__(
         self,
         config: LLMConfig | None = None,
-        client: AsyncOpenAI | AsyncAzureOpenAI | None = None,
+        client: AsyncOpenAI | AsyncAzureOpenAI | OpenAIClient | None = None,
     ):
         """
         Initialize the OpenAIRerankerClient with the provided configuration and client.
@@ -45,7 +45,7 @@ class OpenAIRerankerClient(CrossEncoderClient):
 
         Args:
             config (LLMConfig | None): The configuration for the LLM client, including API key, model, base URL, temperature, and max tokens.
-            client (AsyncOpenAI | AsyncAzureOpenAI | None): An optional async client instance to use. If not provided, a new AsyncOpenAI client is created.
+            client (AsyncOpenAI | AsyncAzureOpenAI | OpenAIClient | None): An optional async client instance to use. If not provided, a new AsyncOpenAI client is created.
         """
         if config is None:
             config = LLMConfig()
@@ -53,6 +53,8 @@ class OpenAIRerankerClient(CrossEncoderClient):
         self.config = config
         if client is None:
             self.client = AsyncOpenAI(api_key=config.api_key, base_url=config.base_url)
+        elif isinstance(client, OpenAIClient):
+            self.client = client.client
         else:
             self.client = client
 

{graphiti_core-0.15.0 → graphiti_core-0.15.1}/graphiti_core/driver/__init__.py

@@ -14,7 +14,6 @@ See the License for the specific language governing permissions and
 limitations under the License.
 """
 
-from falkordb import FalkorDB
 from neo4j import Neo4jDriver
 
-__all__ = ['Neo4jDriver', 'FalkorDB']
+__all__ = ['Neo4jDriver']

{graphiti_core-0.15.0 → graphiti_core-0.15.1}/graphiti_core/driver/falkordb_driver.py

@@ -16,10 +16,21 @@ limitations under the License.
 
 import logging
 from datetime import datetime
-from typing import Any
-
-from falkordb import Graph as FalkorGraph  # type: ignore
-from falkordb.asyncio import FalkorDB  # type: ignore
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from falkordb import Graph as FalkorGraph
+    from falkordb.asyncio import FalkorDB
+else:
+    try:
+        from falkordb import Graph as FalkorGraph
+        from falkordb.asyncio import FalkorDB
+    except ImportError:
+        # If falkordb is not installed, raise an ImportError
+        raise ImportError(
+            'falkordb is required for FalkorDriver. '
+            'Install it with: pip install graphiti-core[falkordb]'
+        ) from None
 
 from graphiti_core.driver.driver import GraphDriver, GraphDriverSession
 from graphiti_core.helpers import DEFAULT_DATABASE

{graphiti_core-0.15.0 → graphiti_core-0.15.1}/graphiti_core/embedder/gemini.py

@@ -15,9 +15,21 @@ limitations under the License.
 """
 
 from collections.abc import Iterable
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from google import genai
+    from google.genai import types
+else:
+    try:
+        from google import genai
+        from google.genai import types
+    except ImportError:
+        raise ImportError(
+            'google-genai is required for GeminiEmbedder. '
+            'Install it with: pip install graphiti-core[google-genai]'
+        ) from None
 
-from google import genai  # type: ignore
-from google.genai import types  # type: ignore
 from pydantic import Field
 
 from .client import EmbedderClient, EmbedderConfig

{graphiti_core-0.15.0 → graphiti_core-0.15.1}/graphiti_core/embedder/voyage.py

@@ -15,8 +15,19 @@ limitations under the License.
 """
 
 from collections.abc import Iterable
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    import voyageai
+else:
+    try:
+        import voyageai
+    except ImportError:
+        raise ImportError(
+            'voyageai is required for VoyageAIEmbedderClient. '
+            'Install it with: pip install graphiti-core[voyageai]'
+        ) from None
 
-import voyageai  # type: ignore
 from pydantic import Field
 
 from .client import EmbedderClient, EmbedderConfig

{graphiti_core-0.15.0 → graphiti_core-0.15.1}/graphiti_core/graphiti.py

@@ -166,7 +166,7 @@ class Graphiti:
             self.driver = graph_driver
         else:
             if uri is None:
-                raise ValueError("uri must be provided when graph_driver is None")
+                raise ValueError('uri must be provided when graph_driver is None')
             self.driver = Neo4jDriver(uri, user, password)
 
         self.database = DEFAULT_DATABASE

{graphiti_core-0.15.0 → graphiti_core-0.15.1}/graphiti_core/llm_client/anthropic_client.py

@@ -19,11 +19,8 @@ import logging
 import os
 import typing
 from json import JSONDecodeError
-from typing import Literal
+from typing import TYPE_CHECKING, Literal
 
-import anthropic
-from anthropic import AsyncAnthropic
-from anthropic.types import MessageParam, ToolChoiceParam, ToolUnionParam
 from pydantic import BaseModel, ValidationError
 
 from ..prompts.models import Message
@@ -31,6 +28,22 @@ from .client import LLMClient
 from .config import DEFAULT_MAX_TOKENS, LLMConfig, ModelSize
 from .errors import RateLimitError, RefusalError
 
+if TYPE_CHECKING:
+    import anthropic
+    from anthropic import AsyncAnthropic
+    from anthropic.types import MessageParam, ToolChoiceParam, ToolUnionParam
+else:
+    try:
+        import anthropic
+        from anthropic import AsyncAnthropic
+        from anthropic.types import MessageParam, ToolChoiceParam, ToolUnionParam
+    except ImportError:
+        raise ImportError(
+            'anthropic is required for AnthropicClient. '
+            'Install it with: pip install graphiti-core[anthropic]'
+        ) from None
+
+
 logger = logging.getLogger(__name__)
 
 AnthropicModel = Literal[

{graphiti_core-0.15.0 → graphiti_core-0.15.1}/graphiti_core/llm_client/gemini_client.py

@@ -17,10 +17,8 @@ limitations under the License.
 import json
 import logging
 import typing
-from typing import ClassVar
+from typing import TYPE_CHECKING, ClassVar
 
-from google import genai  # type: ignore
-from google.genai import types  # type: ignore
 from pydantic import BaseModel
 
 from ..prompts.models import Message
@@ -28,6 +26,21 @@ from .client import MULTILINGUAL_EXTRACTION_RESPONSES, LLMClient
 from .config import DEFAULT_MAX_TOKENS, LLMConfig, ModelSize
 from .errors import RateLimitError
 
+if TYPE_CHECKING:
+    from google import genai
+    from google.genai import types
+else:
+    try:
+        from google import genai
+        from google.genai import types
+    except ImportError:
+        # If gemini client is not installed, raise an ImportError
+        raise ImportError(
+            'google-genai is required for GeminiClient. '
+            'Install it with: pip install graphiti-core[google-genai]'
+        ) from None
+
+
 logger = logging.getLogger(__name__)
 
 DEFAULT_MODEL = 'gemini-2.5-flash'

{graphiti_core-0.15.0 → graphiti_core-0.15.1}/graphiti_core/llm_client/groq_client.py

@@ -17,10 +17,21 @@ limitations under the License.
 import json
 import logging
 import typing
+from typing import TYPE_CHECKING
 
-import groq
-from groq import AsyncGroq
-from groq.types.chat import ChatCompletionMessageParam
+if TYPE_CHECKING:
+    import groq
+    from groq import AsyncGroq
+    from groq.types.chat import ChatCompletionMessageParam
+else:
+    try:
+        import groq
+        from groq import AsyncGroq
+        from groq.types.chat import ChatCompletionMessageParam
+    except ImportError:
+        raise ImportError(
+            'groq is required for GroqClient. Install it with: pip install graphiti-core[groq]'
+        ) from None
 from pydantic import BaseModel
 
 from ..prompts.models import Message

{graphiti_core-0.15.0 → graphiti_core-0.15.1}/graphiti_core/nodes.py

@@ -542,12 +542,12 @@ class CommunityNode(Node):
 def get_episodic_node_from_record(record: Any) -> EpisodicNode:
     created_at = parse_db_date(record['created_at'])
     valid_at = parse_db_date(record['valid_at'])
-    
+
     if created_at is None:
-        raise ValueError(f"created_at cannot be None for episode {record.get('uuid', 'unknown')}")
+        raise ValueError(f'created_at cannot be None for episode {record.get("uuid", "unknown")}')
     if valid_at is None:
-        raise ValueError(f"valid_at cannot be None for episode {record.get('uuid', 'unknown')}")
-    
+        raise ValueError(f'valid_at cannot be None for episode {record.get("uuid", "unknown")}')
+
     return EpisodicNode(
         content=record['content'],
         created_at=created_at,

{graphiti_core-0.15.0 → graphiti_core-0.15.1}/graphiti_core/search/search_utils.py

@@ -539,7 +539,8 @@ async def community_fulltext_search(
             comm.group_id AS group_id, 
             comm.name AS name, 
             comm.created_at AS created_at, 
-            comm.summary AS summary
+            comm.summary AS summary,
+            comm.name_embedding AS name_embedding
         ORDER BY score DESC
         LIMIT $limit
         """
@@ -589,7 +590,8 @@ async def community_similarity_search(
                comm.group_id AS group_id,
                comm.name AS name, 
                comm.created_at AS created_at, 
-               comm.summary AS summary
+               comm.summary AS summary,
+               comm.name_embedding AS name_embedding
            ORDER BY score DESC
            LIMIT $limit
         """

{graphiti_core-0.15.0 → graphiti_core-0.15.1}/graphiti_core/utils/maintenance/graph_data_operations.py

@@ -140,7 +140,8 @@ async def retrieve_episodes(
     episodes = [
         EpisodicNode(
             content=record['content'],
-            created_at=parse_db_date(record['created_at']) or datetime.min.replace(tzinfo=timezone.utc),
+            created_at=parse_db_date(record['created_at'])
+            or datetime.min.replace(tzinfo=timezone.utc),
             valid_at=parse_db_date(record['valid_at']) or datetime.min.replace(tzinfo=timezone.utc),
             uuid=record['uuid'],
             group_id=record['group_id'],

{graphiti_core-0.15.0 → graphiti_core-0.15.1}/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