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 여유 디스크 공간

퀵 스타트 🚀

  1. 저장소 복제:

  2. 환경 변수 설정:

  3. 설정으로 .env를 편집하세요:

  4. 예배 시작:

  5. 설치 확인:

대안: 환경 변수

환경 변수를 직접 사용할 수 있습니다:

🔧 구성

서비스 포트 🌐

서비스 항구 목적
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 🚀

  1. Clone the repository:
git clone https://github.com/gifflet/graphiti-mcp-server.git
cd graphiti-mcp-server
  1. Set up environment variables:
cp .env.sample .env
  1. Edit .env with 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
  1. Start the services:
docker compose up -d
  1. 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

GitHub에서 전체 README 보기

설치

docker run -d \
MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "Graphiti": { "command": "uv", "args": ["run", "graphiti_mcp_server.py"], "env": { "OPENAI_API_KEY": "your_key_here" } } } }