Graphiti MCP
Graphiti MCP Server
MCP-сервер Graphiti от Zep: долгая память агента в виде графа знаний с учетом времени на FalkorDB или Neo4j
Установка
git clone https://github.com/getzep/graphiti.git
cd graphiti/mcp_server
docker compose upПоднимает FalkorDB и MCP-сервер в одном контейнере. Перед запуском задайте ключ LLM-провайдера.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Graphiti строит граф знаний, который постепенно пополняется разговорами, документами и JSON и хранит историю изменений фактов. MCP-сервер из папки mcp_server дает агенту инструменты для добавления эпизодов, поиска фактов и сущностей семантическим и гибридным поиском, группировки данных по group_id и обслуживания графа. Из текста извлекаются типизированные сущности: предпочтения, требования, процедуры, организации, события и другие. Эпизоды обрабатываются в очереди с настраиваемым параллелизмом.
Для кого. Для разработчиков, которым агент должен помнить контекст между сессиями и проектами.
Подходит, если
- Агенту нужна долгая память о предпочтениях пользователя и решениях по проекту
- Нужно отслеживать, как факты менялись со временем
- Уже используете Neo4j или готовы поднять контейнер с FalkorDB
Не подходит, если
- Хватает простого файла заметок или CLAUDE.md
- Нет возможности платить за много вызовов LLM при загрузке данных
Пример запроса к агенту
Запомни, что в этом проекте мы используем pnpm и не трогаем папку legacyОграничения
Сервер помечен как экспериментальный. Нужны Docker или Python 3.10+ с uv и ключ LLM-провайдера, по умолчанию OpenAI, который из России без VPN недоступен; можно подключить Ollama. Каждый эпизод требует нескольких вызовов модели, маленькие локальные модели часто ломают структурированный вывод.
Как отключить. Остановите контейнеры docker compose и удалите сервер graphiti-memory из конфигурации MCP клиента.
MCP
- Транспорт
- http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| OPENAI_API_KEY обязательная, секрет | Ключ LLM-провайдера по умолчанию, при смене провайдера нужен его ключ |
| NEO4J_URI | Адрес Neo4j, если используется вместо FalkorDB |
| NEO4J_PASSWORD секрет | Пароль Neo4j |
| SEMAPHORE_LIMIT | Сколько эпизодов обрабатывать параллельно |
Проверка безопасности
- Отправляет содержимое эпизодов внешнему LLM-провайдеру
- Запускает контейнеры с базой данных
Коротко о README
README сервера объясняет, чем Graphiti отличается от обычного RAG, и перечисляет возможности MCP. Быстрый старт предлагает docker compose с FalkorDB или отдельную связку с Neo4j, а для клиентов только со stdio конфигурацию через uv. Подробно описан config.yaml: база, провайдер модели и эмбеддингов, типы сущностей, лимит параллельности. Лицензия Apache-2.0.
Частые вопросы
Какую базу выбрать?
По умолчанию FalkorDB поставляется в одном контейнере с сервером. Для продакшена README рекомендует Neo4j.
Можно без OpenAI?
Да, поддерживаются Anthropic, Gemini, Groq, Azure OpenAI и OpenAI-совместимые эндпоинты вроде Ollama.
Похожие
Открытый личный AI-ассистент на своем компьютере: отвечает в Telegram, Slack, Discord и WhatsApp, расширяется скиллами и плагинами
Самообучающийся агент от Nous Research: терминал, мессенджеры, cron-задачи и скиллы, которые он пишет сам
Открытый агент для программирования в терминале и на десктопе с режимами разработки и планирования
Агент Anthropic для терминала, IDE и GitHub: понимает кодовую базу, выполняет задачи и работает с git