elvismdev/mem0-mcp-selfhosted

Self-hosted MCP сервер для долговременной памяти в Claude Code. Использует Qdrant, Neo4j и Ollama, поддерживает Anthropic или Ollama как LLM. 11 инструментов: добавление, поиск, удаление, граф связей.

README

11 инструментов

Версии

Установить сервер

mem0-mcp-selfhosted

Self-hosted mem0 MCP server for Claude Code. Run a complete memory server against self-hosted Qdrant + Neo4j + Ollama, with your choice of Anthropic (Claude) or Ollama as the main LLM.

Uses the mem0ai package directly as a library, supports both Claude's OAT token and fully local Ollama setups, and exposes 11 MCP tools for full memory management.

Prerequisites

Service	Required	Purpose
Qdrant	Yes	Vector memory storage and search
Ollama	Yes	Embedding generation (`bge-m3`) and optionally local LLM
Neo4j 5+	Optional	Knowledge graph (entity relationships)
Google API Key	Optional	Required only for `gemini`/`gemini_split` graph providers

Python >= 3.10 and uv.

Authentication: The default setup uses Claude (Anthropic) as the LLM for fact extraction. No API key needed, the server automatically uses your Claude Code session token. For fully local setups, set MEM0_PROVIDER=ollama. See Authentication for advanced options.

Quick Start

Default (Anthropic)

Add the MCP server globally (available across all projects):

Инструменты были проиндексированы: 11.09.2026

add_memory

Сохраняет новое воспоминание. Требуется хотя бы один из параметров: user_id, agent_id или run_id.

Параметры

agent_idstring | null
Идентификатор области действия агента.
enable_graphboolean | null
Извлекает и запрашивает актуальную документацию и примеры кода из Context7 для любой программной библиотеки или фреймворка. Сначала необходимо вызвать инструмент 'Resolve Context7 Library ID', чтобы получить точный идентификатор библиотеки, совместимый с Context7 и необходимый для использования этого инструмента, ЗА ИСКЛЮЧЕНИЕМ случаев, когда пользователь явно указывает идентификатор библиотеки в формате '/org/project' или '/org/project/version' в своём запросе. Не вызывайте этот инструмент более 3 раз для одного вопроса.
inferboolean | null
Если true (по умолчанию), LLM извлекает ключевые факты. Если false, сохраняет сырой текст.
messagesobject[] | null
Структурированная история разговора (словари роль/содержимое). Если указана, она имеет приоритет над текстом.
metadataobject | null
Произвольные метаданные JSON для хранения вместе с памятью.
run_idstring | null
Запускает идентификатор области.
textstringобязательный
Текст для сохранения в память. Внутри преобразуется в формат сообщений.
user_idstring | null
Идентификатор области действия пользователя. По умолчанию: MEM0_USER_ID.

delete_all_memories

Массово удаляет все воспоминания в заданной области. Требуется хотя бы один фильтр. НИКОГДА не вызывает memory.delete_all() - использует безопасное массовое удаление.

Параметры

agent_idstring | null
Скоуп агента для удаления.
run_idstring | null
Запустите область для удаления.
user_idstring | null
Область пользователя для удаления.

delete_entities

Удаляет сущность и каскадно удаляет все её воспоминания. Функционально эквивалентно delete_all_memories в self-hosted режиме.

Параметры

agent_idstring | null
Сущность агента для удаления.
run_idstring | null
Запускает сущность для удаления.
user_idstring | null
Сущность пользователя для удаления (каскадно удаляет все воспоминания).

delete_memory

Удаляет одну запись памяти.

Параметры

memory_idstringобязательный
Точный UUID памяти для удаления.

get_memories

Перелистывает воспоминания, применяя фильтры вместо поиска.

Параметры

agent_idstring | null
Область действия агента.
limitinteger | null
Максимальное количество воспоминаний для возврата.
run_idstring | null
Запустить скоуп.
user_idstring | null
Область пользователя. По умолчанию используется MEM0_USER_ID.

get_memory

Получает одну запись памяти по её ID.

Параметры

memory_idstringобязательный
Точный UUID памяти для получения.

list_entities

Перечисляет пользователей/агентов/запуски, которые в данный момент хранят воспоминания. Использует Qdrant Facet API (v1.12+) для агрегации на стороне сервера, с запасным вариантом scroll+dedupe для старых версий.

Параметры

Без параметров.

mcp_get_entity

Получает все связи для конкретной сущности (двунаправленные).

Параметры

namestringобязательный
Точное имя сущности для поиска.

mcp_search_graph

Ищет сущности по подстроке имени/идентификатора в графе знаний Neo4j.

Параметры

querystringобязательный
Сущность или тема для поиска (например, 'Python', 'TypeScript').

search_memories

Выполняет семантический поиск по существующим воспоминаниям.

Параметры

agent_idstring | null
Область действия агента.
enable_graphboolean | null
Переопределяет переключатель графа по умолчанию.
filtersobject | null
Дополнительные структурированные условия фильтрации.
limitinteger | null
Максимальное количество результатов
querystringобязательный
Описание того, что нужно найти.
rerankboolean | null
Применять ли реранжирование.
run_idstring | null
Запустить скоуп.
thresholdnumber | null
Минимальный порог релевантности (0.0–1.0).
user_idstring | null
Область пользователя. По умолчанию используется MEM0_USER_ID.

update_memory

Перезаписывает текст существующей памяти. Повторно встраивает и повторно индексирует.

Параметры

memory_idstringобязательный
Точный UUID памяти для обновления.
textstringобязательный
Текст для замены памяти.

Github Сайт сервера

Конфиг для установки сервера

{
  "command": "uvx",
  "args": [
    "--from",
    "git+https://github.com/elvismdev/mem0-mcp-selfhosted.git",
    "mem0-mcp-selfhosted"
  ],
  "env": {
    "MEM0_PROVIDER": "ollama",
    "MEM0_LLM_MODEL": "qwen3:14b",
    "MEM0_USER_ID": "your-user-id"
  }
}

FAQ

Для чего этот сервер?

Этот MCP-сервер даёт Claude Code постоянную память. Он хранит факты и контекст проекта между сессиями, используя self-hosted Qdrant, Neo4j и Ollama. Разработчики запускают полностью локальную память без облачных провайдеров. Сервер автоматически сохраняет итоги сессии и подгружает релевантные воспоминания при старте, так что агент не забывает архитектуру или принятые решения.

Что он умеет?

Этот сервер даёт Claude Code полноценную долговременную память: он запоминает факты из сессий, ищет похожие воспоминания по смыслу, показывает и редактирует сохранённые данные. Можно фильтровать по пользователям, агентам или run_id, удалять отдельные записи или целыми пачками. Ещё умеет искать сущности в графе Neo4j и показывать их связи. Работает на self-hosted Qdrant и Ollama, подходит для полностью локального использования.

Информация о сервере

Номер в рейтинге: #178
Звезд на Github: 108
Форков на Github: 45
Язык реализации: Python
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 10.09 в 23:09
Идентификатор: SwrlSHqctXXcEAKa
Категории: RAG-системы, Базы данных, Знания и память, ИИ и машинное обучение, Инструменты для разработчиков, Поиск