Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Nov 12, 2025

Update Graphiti MCP Server documentation to align with the official Zep configuration and README.

  • Update Quick Start section to use official Zep docker-compose files
  • Add two deployment options: combined image and separate containers
  • Replace falkordb/graphiti-knowledge-graph-mcp with zepai/knowledge-graph-mcp
  • Update environment variables (FALKORDB_URI instead of host/port, remove DATABASE_TYPE)
  • Update FalkorDB Cloud configuration section
  • Update monitoring/troubleshooting commands for both deployment options
  • Add link to official Zep Graphiti MCP Docker setup in Resources
  • Update Docker Hub link to point to zepai/knowledge-graph-mcp
  • Add zepai to wordlist
  • Run security checks (CodeQL)
  • Fix spellcheck failures (added UI, yml, Zep's, Embedder, Gemini, gpt to wordlist)
  • Align comprehensive documentation with official Graphiti MCP README
    • Updated Features section with episode management, entity management, search capabilities, and queue-based processing
    • Added multiple LLM provider support documentation (OpenAI, Anthropic, Gemini, Groq, Azure OpenAI)
    • Added multiple embedding provider support (OpenAI, Voyage, Sentence Transformers, Gemini)
    • Documented built-in entity types (Preference, Requirement, Procedure, Location, Event, Organization, Document, Topic, Object)
    • Corrected MCP transport from SSE to HTTP with proper /mcp/ endpoint
    • Added concurrency and rate limiting guidance with SEMAPHORE_LIMIT tuning recommendations
    • Updated client integration examples for Claude Desktop, Cursor IDE, and VS Code
    • Updated available tools list (add_episode, search_nodes, search_facts, delete_entity_edge, delete_episode, get_entity_edge, get_episodes, clear_graph)
    • Added health check endpoint documentation

Summary:
Successfully updated the Graphiti MCP Server documentation to fully align with the official Zep implementation from https://github.com/getzep/graphiti/blob/main/mcp_server/README.md. The documentation now accurately reflects HTTP transport protocol, multiple LLM and embedding providers, entity types for structured knowledge extraction, proper MCP endpoint configuration at /mcp/, and comprehensive configuration guidance including concurrency tuning for different provider tiers.

Files Changed:

  • agentic-memory/graphiti-mcp-server.md - Comprehensive updates to match official Graphiti MCP documentation including features, configuration, entity types, client integration, and available tools
  • .wordlist.txt - Added "zepai", "UI", "yml", "Zep's", "Embedder", "Gemini", and "gpt" for spell checking

Security Summary:
No security vulnerabilities detected. This is a documentation-only change with no code modifications.

Original prompt

This section details on the original issue you should resolve

<issue_title>update Graphiti-MCP docs</issue_title>
<issue_description>The graphiti-mcp-server.html page should be updated to use the official MCP server from Zep
See: https://github.com/getzep/graphiti/tree/main/mcp_server

Instead of using: falkordb/graphiti-knowledge-graph-mcp

Use:

https://github.com/getzep/graphiti/blob/main/mcp_server/docker/docker-compose.yml
or
https://github.com/getzep/graphiti/blob/main/mcp_server/docker/docker-compose-falkordb.yml

Ref: https://github.com/getzep/graphiti/blob/main/mcp_server/docker/README.md

</issue_description>

Comments on the Issue (you are @copilot in this section)


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Nov 12, 2025

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.


Comment @coderabbitai help to get the list of available commands and usage tips.

Copilot AI and others added 2 commits November 12, 2025 08:22
Co-authored-by: gkorland <753206+gkorland@users.noreply.github.com>
Co-authored-by: gkorland <753206+gkorland@users.noreply.github.com>
Copilot AI changed the title [WIP] Update Graphiti-MCP documentation to official server Update Graphiti MCP docs to use official Zep implementation Nov 12, 2025
Copilot AI requested a review from gkorland November 12, 2025 08:27
@gkorland
Copy link
Contributor

@copilot please see spellcheck failing

@gkorland gkorland marked this pull request as ready for review November 12, 2025 08:56
Co-authored-by: gkorland <753206+gkorland@users.noreply.github.com>
Copy link
Contributor Author

Copilot AI commented Nov 12, 2025

@copilot please see spellcheck failing

Fixed in 1d4a140. Added missing words to wordlist: "UI", "yml", and "Zep's". Spellcheck now passes.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • esm.ubuntu.com
    • Triggering command: /usr/lib/apt/methods/https (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

@gkorland
Copy link
Contributor

@copilot please review again the Graphiti MCP server docs https://github.com/getzep/graphiti/blob/main/mcp_server/README.md and adapt accordingly

…ty types, HTTP transport details

Co-authored-by: gkorland <753206+gkorland@users.noreply.github.com>
Copy link
Contributor Author

Copilot AI commented Nov 12, 2025

@copilot please review again the Graphiti MCP server docs https://github.com/getzep/graphiti/blob/main/mcp_server/README.md and adapt accordingly

Updated in 78c142f. The documentation now aligns with the official Graphiti MCP README including:

  • HTTP transport with /mcp/ endpoint (corrected from SSE)
  • Multiple LLM provider support (OpenAI, Anthropic, Gemini, Groq, Azure)
  • Entity types documentation (Preference, Requirement, Procedure, Location, Event, Organization, Document, Topic, Object)
  • Concurrency and rate limiting guidance with SEMAPHORE_LIMIT
  • Updated client integration examples for Claude, Cursor, and VS Code
  • Comprehensive feature list and available tools

Copilot AI changed the title Update Graphiti MCP docs to use official Zep implementation Update Graphiti MCP docs to align with official Zep implementation Nov 12, 2025
@gkorland gkorland merged commit 72cd374 into main Nov 12, 2025
5 checks passed
@gkorland gkorland deleted the copilot/update-graphiti-mcp-docs branch November 12, 2025 22:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

update Graphiti-MCP docs

2 participants