개발자 경험과 다중 프로젝트 지원에 중점을 둔 getzep/graphiti 예제의 포크입니다. Graphiti는 텍스트에서 엔터티와 관계를 추출하여 Neo4j에 저장합니다. 이 저장소는 루트 서버와 Docker에서 프로젝트별 MCP 서버를 동시에 실행하는 CLI를 추가하여 여러 지식 그래프가 같은 데이터베이스를 공유합니다.

퀵 스타트

1. 설치 및 복제

2. 발사 서비스

루트 서버는 포트 8000에서 실행되며; 프로젝트 컨테이너는 8001에서 시작합니다. 3. 프로젝트 만들기

컨테이너를 시작하기 위해 어디서든 graphiti compose && graphiti up -d를 재실행 하세요.

한 번 진행하면 다음과 같은 것이 가능합니다:

• http://localhost:8000/graphiti/status를 확인하세요.
• MCP 호환 도구를 http://localhost:800{N}/sse에 연결.
• .env의 자격 증명을 사용하여 http://localhost:7474에서 Neo4j를 탐색하세요.

보안 주의사항

NEO4J_PASSWORD가 [[T6]로 남아 있으면 서버는 GRAPHITI_ENV=dev가 아니면 시작을 거부합니다. 운영 환경에서는 항상 강력한 비밀번호를 사용하세요.

왜 이 포크야?

업스트림 저장소는 compose 파일당 하나의 서버를 가정합니다. 여기서는 하나의 compose 파일이 Neo4j를 공유하는 여러 프로젝트 서버를 관리합니다.

Graphiti MCP Server

Fork of the 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.

Quick Start

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.

Why this fork?

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.

Highlights

• Project isolation – different extraction rules or models never collide.
• Editor auto‑discovery – ports are written to .cursor/mcp.json.
• Crash containment – a bad prompt only restarts its container.
• Hot reload – tweak a project’s config and run graphiti reload .

Leave mcp-projects.yaml empty if you only need the root server.

Danger zone

Setting NEO4J_DESTROY_ENTIRE_GRAPH=true wipes all projects the next time you run graphiti up. Use with care.

Contributing

PRs and issues are welcome.

© 2025 rawr‑ai • MIT License