Skip to content
Back to search

mcp-graphiti

Graphiti Model Context Protocol (MCP) Server - An MCP server for knowledge graph management via Graphiti

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/rawr-ai--mcp-graphiti/badge.svg)](/listings/rawr-ai--mcp-graphiti)

HTML

<a href="/listings/rawr-ai--mcp-graphiti"><img src="/api/listings/rawr-ai--mcp-graphiti/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. **Install and clone**

   pipx install 'git+https://github.com/rawr-ai/mcp-graphiti.git'
   git clone https://github.com/rawr-ai/mcp-graphiti.git
   cd mcp-graphiti
   cp .env.example .env  # fill in Neo4j credentials and your OpenAI key

2. **Launch services**

   graphiti compose   # generates docker-compose.yml and updates .cursor/mcp.json
   graphiti up -d

The root server runs on port **8000**; project containers start at **8001**. 3. **Create a project**

   cd /path/to/my-kg
   graphiti init my-kg        # writes ai/graph/mcp-config.yaml
   # add entity definitions under ai/graph/entities/

Rerun `graphiti compose && graphiti up -d` from anywhere to start its container.

Once running you can: - Check `http://localhost:8000/graphiti/status`. - Connect MCP‑compatible tools to `http://localhost:800{N}/sse`. - Browse Neo4j at `http://localhost:7474` using the credentials in `.env`.

Security note

If `NEO4J_PASSWORD` remains `password` the server refuses to start unless `GRAPHITI_ENV=dev`. Always use a strong password in production.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 53 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Graphiti MCP Server
  2. Fork of the [getzep/graphiti](https://github.com/getzep/graphiti) example with a focus on developer experience and multi‑project support. Graphiti extracts entities and relationships from text and stores them in Neo4j. This repo adds a CLI that spins up a root server plus project‑specific MCP servers in Docker so several knowledge graphs share the same database.
  3. ## Quick Start
  4. 1. **Install and clone**
  5. ```bash
  6. pipx install 'git+https://github.com/rawr-ai/mcp-graphiti.git'
  7. git clone https://github.com/rawr-ai/mcp-graphiti.git
  8. cd mcp-graphiti
  9. cp .env.example .env # fill in Neo4j credentials and your OpenAI key
  10. ```
  11. 2. **Launch services**
  12. ```bash
  13. graphiti compose # generates docker-compose.yml and updates .cursor/mcp.json
  14. graphiti up -d
  15. ```
  16. The root server runs on port **8000**; project containers start at **8001**.
  17. 3. **Create a project**
  18. ```bash
  19. cd /path/to/my-kg
  20. graphiti init my-kg # writes ai/graph/mcp-config.yaml
  21. # add entity definitions under ai/graph/entities/
  22. ```
  23. Rerun `graphiti compose && graphiti up -d` from anywhere to start its container.
  24. Once running you can:
  25. - Check `http://localhost:8000/graphiti/status`.
  26. - Connect MCP‑compatible tools to `http://localhost:800{N}/sse`.
  27. - Browse Neo4j at `http://localhost:7474` using the credentials in `.env`.
  28. ### Security note
  29. If `NEO4J_PASSWORD` remains `password` the server refuses to start unless `GRAPHITI_ENV=dev`. Always use a strong password in production.
  30. ## Why this fork?
  31. The upstream repository assumes one server per compose file. Here a single compose file manages many project servers that share Neo4j. Each service gets its own `group_id`, entities and model so projects stay isolated while running on the same database.
  32. ### Highlights
  33. - **Project isolation** – different extraction rules or models never collide.
  34. - **Editor auto‑discovery** – ports are written to `.cursor/mcp.json`.
  35. - **Crash containment** – a bad prompt only restarts its container.
  36. - **Hot reload** – tweak a project's config and run `graphiti reload <container>`.
  37. Leave `mcp-projects.yaml` empty if you only need the root server.
  38. ## Danger zone
  39. Setting `NEO4J_DESTROY_ENTIRE_GRAPH=true` wipes *all* projects the next time you run `graphiti up`. Use with care.
  40. ## Contributing
  41. PRs and issues are welcome.
  42. © 2025 rawr‑ai • MIT License

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.