cognee-mcp

cognee-mcp — MCP-сервер сообщества (автор — topoteretes). Менеджер памяти cognee для ИИ-приложений на графовых и векторных хранилищах. Ставится через pip или через Docker. Лицензия Apache-2.0.

Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
topoteretes
Лицензия
Apache-2.0
Транспорт
stdio
Авторизация
api_key
ОС
Не указана
Языки
python

Уровень риска: high

Сохраняемые данные обрабатываются языковой моделью по ключу `LLM_API_KEY`; `forget` может удалить всю память.

Настройка клиентов

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"cognee-http\": {\n      \"url\": \"http://localhost:8000/mcp\"\n    }\n  }\n}",
    "file": "~/.cursor/mcp.json",
    "lang": "json",
    "notes": "Дословно из README, режим Streamable HTTP",
    "verified": "docs"
}

Что умеет

cognee-mcp запускает движок памяти cognee как MCP-сервер. С ним агенты строят память и обращаются к ней из любого клиента с поддержкой MCP — в терминале или в редакторе кода. Cognee хранит знания в виде графа и умеет быстро кэшировать данные текущей сессии.

Набор инструментов намеренно минимальный:

Инструмент Что делает
remember Сохраняет данные: в быстрый кэш сессии или в постоянную графовую память
recall Запрос к памяти с необязательными параметрами сессии и поиска
forget Удаляет один элемент, набор данных или всю свою память
code_search Поиск по графу кода: символы, зависимости, архитектура и влияние изменений

Сервер поддерживает три транспорта: Streamable HTTP (--transport http, рекомендуется для веб-развёртываний), SSE (--transport sse) и stdio (по умолчанию). Кроме локального режима есть облачный — подключение к Cognee Cloud через --serve-url или COGNEE_SERVICE_URL — и режим API для подключения к уже запущенному серверу Cognee на FastAPI (API_URL). Все действия пишутся в ротируемый файл журнала.

Кому подойдёт

  • Разработчикам агентов: долговременная память между сессиями без своей инфраструктуры.
  • Командам с большими кодовыми базами: поиск по графу кода и оценка влияния изменений.
  • Тем, кто уже использует cognee и хочет подключить его к Claude Code или Cursor.

Похожие серверы — в категории знания и память.

Установка

Проще всего запустить готовый образ Docker. Режим транспорта в Docker задаётся переменной TRANSPORT_MODE, а не флагом:

docker run -e TRANSPORT_MODE=http --env-file ./.env -p 8000:8000 --rm -it cognee/cognee-mcp:main

Дополнительные группы зависимостей подключаются переменной EXTRAS, можно сразу несколько через запятую: хранилище S3 (aws), PostgreSQL (postgres), графовые базы Neo4j (neo4j) и AWS Neptune (neptune), Redis (redis), локальные модели через Ollama или Hugging Face, обработка документов (docs), трассировка OpenTelemetry (tracing), интеграции с LangChain и LlamaIndex. Полный список — в pyproject.toml проекта. Из исходников сервер ставится через uv: uv sync --dev --all-extras --reinstall в папке cognee-mcp, затем python src/server.py. Для быстрого старта с настройками по умолчанию нужен ключ API языковой модели в .env (LLM_API_KEY).

Подключение к клиентам

Конфиги приведены дословно из README для режима Streamable HTTP, когда сервер запущен на localhost:8000. Для SSE в README есть такие же примеры с адресом /sse. Общий порядок — в инструкции как подключить MCP.

claude mcp add cognee-http -t http http://localhost:8000/mcp

Проверка

В Claude Code выполните claude mcp list — сервер должен быть в списке. Затем попросите агента запомнить факт и в новой сессии спросите о нём: агент вызовет recall.

Примеры задач

Запомни архитектурные решения из этого документа и используй их в следующих задачах.
Какие модули затронет изменение функции авторизации? Посмотри по графу кода.

Риски

Сервер хранит в памяти всё, что агент решит запомнить, а forget может удалить отдельные данные, наборы или всю память. Для обработки данных cognee обращается к языковой модели по ключу LLM_API_KEY — сохраняемые данные уходят этому провайдеру. В облачном режиме память хранится в Cognee Cloud.

Как снизить риски: запускайте сервер локально, если данные чувствительные; не открывайте порт 8000 наружу без защиты; не сохраняйте в память пароли и ключи. Лицензия — Apache-2.0.

Частые вопросы

Какой транспорт выбрать?

Для локальной работы подходит stdio (по умолчанию), для развёртывания на сервере README рекомендует Streamable HTTP.

Почему в Docker не работает флаг --transport?

В контейнере транспорт задаётся переменной TRANSPORT_MODE, а флаг --transport работает только при прямом запуске python src/server.py.

Основы протокола — на странице что такое MCP-сервер.

Инструменты

  • remember
  • recall
  • forget
  • code_search

Похожие MCP-серверы

Memory

Эталонный сервер постоянной памяти на основе графа знаний.

Риск: high Лицензия: NOASSERTION ★ 92 089

Context7

Context7 даёт агентам актуальную документацию и примеры кода библиотек нужных версий.

Риск: medium Лицензия: MIT ★ 65 087

hindsight

Долговременная память для ИИ-агентов по образцу человеческой.

Риск: medium Лицензия: MIT ★ 61 836

mcp-docs-server

Прямой доступ ИИ-ассистента к базе знаний Mastra.ai.

Риск: medium Лицензия: NOASSERTION ★ 29 505

Источники