GG 

gifflet/graphiti-mcp-server
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
142 stars 18 forks 품질 69 트렌드 16MIT
gifflet/graphiti-mcp-server는 https://github.com/gifflet/graphiti-mcp-server.에서 가져온 MCP 서버 후보입니다.
개요
gifflet/graphiti-mcp-server는 https://github.com/gifflet/graphiti-mcp-server.에서 가져온 MCP 서버 후보입니다.
개요(AI 번역)
🌟 Neo4j로 구축되고 모델 컨텍스트 프로토콜(MCP)과 통합된 AI 에이전트용 강력한 지식 그래프 서버입니다.
🚀 특징
- 🔄 Neo4j를 이용한 동적 지식 그래프 관리
- 🤖 OpenAI 모델과의 원활한 통합
- 🔌 MCP(모델 컨텍스트 프로토콜) 지원
- 🐳 도커 준비 배포
- 🎯 사용자 지정 엔터티 추출 기능
- 🔍 고급 의미 탐색 기능
🛠️ 설치
전제 조건
- 도커 및 도커 컴포스트
- Python 3.10 이상
- OpenAI API 키
- 최소 4GB RAM (권장 8GB)
- 2GB 여유 디스크 공간
퀵 스타트 🚀
-
저장소 복제:
-
환경 변수 설정:
-
설정으로
.env를 편집하세요: -
예배 시작:
-
설치 확인:
대안: 환경 변수
환경 변수를 직접 사용할 수 있습니다:
🔧 구성
서비스 포트 🌐
| 서비스 | 항구 | 목적 |
|---|---|---|
| Neo4j 브라우저 | 7474 | 그래프 시각화용 웹 인터페이스 |
| 네오4j 볼트 | 7687 | 데이터베이스 연결 |
| 그래피티 MCP | 8000 | MCP 서버 엔드포인트 |
환경 변수 🔧
OpenAI 구성
| 변수 | 필수 | 기본 | 설명 |
이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.
README
원문 README의 일부입니다. 원문 보기.
Graphiti MCP Server 🧠
🌟 A powerful knowledge graph server for AI agents, built with Neo4j and integrated with Model Context Protocol (MCP).
🚀 Features
- 🔄 Dynamic knowledge graph management with Neo4j
- 🤖 Seamless integration with OpenAI models
- 🔌 MCP (Model Context Protocol) support
- 🐳 Docker-ready deployment
- 🎯 Custom entity extraction capabilities
- 🔍 Advanced semantic search functionality
🛠️ Installation
Prerequisites
- Docker and Docker Compose
- Python 3.10 or higher
- OpenAI API key
- Minimum 4GB RAM (recommended 8GB)
- 2GB free disk space
Quick Start 🚀
- Clone the repository:
git clone https://github.com/gifflet/graphiti-mcp-server.git
cd graphiti-mcp-server
- Set up environment variables:
cp .env.sample .env
- Edit
.envwith your configuration:
# Required for LLM operations
OPENAI_API_KEY=your_openai_api_key_here
MODEL_NAME=gpt-4.1-mini
# Optional: Custom OpenAI endpoint (e.g., for proxies)
# OPENAI_BASE_URL=https://api.openai.com/v1
# Neo4j Configuration (defaults work with Docker)
NEO4J_URI=bolt://neo4j:7687
NEO4J_USER=neo4j
NEO4J_PASSWORD=demodemo
- Start the services:
docker compose up -d
- Verify installation:
# Check if services are running
docker compose ps
# Check logs
docker compose logs graphiti-mcp
Alternative: Environment Variables
You can run with environment variables directly:
OPENAI_API_KEY=your_key MODEL_NAME=gpt-4.1-mini docker compose up
🔧 Configuration
Service Ports 🌐
| Service | Port | Purpose |
|---|---|---|
| Neo4j Browser | 7474 | Web interface for graph visualization |
| Neo4j Bolt | 7687 | Database connection |
| Graphiti MCP | 8000 | MCP server endpoint |
Environment Variables 🔧
OpenAI Configuration
| Variable | Required | Default | Description |
|---|---|---|---|
OPENAI_API_KEY |
✅ | - | Your OpenAI API key |
OPENAI_BASE_URL |
❌ | - | Custom OpenAI API endpoint (consumed by OpenAI SDK) |
MODEL_NAME |
❌ | gpt-4.1-mini |
Main LLM model to use |
SMALL_MODEL_NAME |
❌ | gpt-4.1-nano |
Small LLM model for lighter tasks |
LLM_TEMPERATURE |
❌ | 0.0 |
LLM temperature (0.0-2.0) |
EMBEDDER_MODEL_NAME |
❌ | text-embedding-3-small |
Embedding model |
Neo4j Configuration
| Variable | Required | Default | Description |
|---|---|---|---|
NEO4J_URI |
❌ | bolt://neo4j:7687 |
Neo4j connection URI |
NEO4J_USER |
❌ | neo4j |
Neo4j username |
NEO4J_PASSWORD |
❌ | demodemo |
Neo4j password |
Server Configuration
설치
docker run -d \설정
{
"mcpServers": {
"Graphiti": {
"command": "uv",
"args": ["run", "graphiti_mcp_server.py"],
"env": {
"OPENAI_API_KEY": "your_key_here"
}
}
}
}