elvismdev/mem0-mcp-selfhosted

elvismdev/mem0-mcp-selfhosted

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

mem0-mcp-selfhosted

mem0-mcp-selfhosted MCP server

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):

Часто задаваемые вопросы

Инструменты были проиндексированы:
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обязательный

    Текст для замены памяти.

Выберите клиент, чтобы установить elvismdev/mem0-mcp-selfhosted:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "elvismdev-mem0-mcp-selfhosted-3iztigzgmr": {
      "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"
      }
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "elvismdev-mem0-mcp-selfhosted-3iztigzgmr": {
      "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"
      }
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "elvismdev-mem0-mcp-selfhosted-3iztigzgmr": {
      "type": "stdio",
      "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"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"elvismdev-mem0-mcp-selfhosted-3iztigzgmr\",\"type\":\"stdio\",\"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\"}}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "elvismdev-mem0-mcp-selfhosted-3iztigzgmr": {
      "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"
      }
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add elvismdev-mem0-mcp-selfhosted-3iztigzgmr --env MEM0_PROVIDER=ollama --env MEM0_LLM_MODEL=qwen3:14b --env MEM0_USER_ID=your-user-id -- uvx --from git+https://github.com/elvismdev/mem0-mcp-selfhosted.git mem0-mcp-selfhosted

Либо через JSON-конфиг:

claude mcp add-json elvismdev-mem0-mcp-selfhosted-3iztigzgmr "{\"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\"}}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add elvismdev-mem0-mcp-selfhosted-3iztigzgmr --env MEM0_PROVIDER=ollama --env MEM0_LLM_MODEL=qwen3:14b --env MEM0_USER_ID=your-user-id -- uvx --from git+https://github.com/elvismdev/mem0-mcp-selfhosted.git mem0-mcp-selfhosted

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.elvismdev-mem0-mcp-selfhosted-3iztigzgmr]
command = "uvx"
args = ["--from", "git+https://github.com/elvismdev/mem0-mcp-selfhosted.git", "mem0-mcp-selfhosted"]

[mcp_servers.elvismdev-mem0-mcp-selfhosted-3iztigzgmr.env]
MEM0_PROVIDER = "ollama"
MEM0_LLM_MODEL = "qwen3:14b"
MEM0_USER_ID = "your-user-id"
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите elvismdev/mem0-mcp-selfhosted, а в поле команды запуска — строку ниже:
uvx --from git+https://github.com/elvismdev/mem0-mcp-selfhosted.git mem0-mcp-selfhosted

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "elvismdev-mem0-mcp-selfhosted-3iztigzgmr": {
      "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"
      }
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "elvismdev-mem0-mcp-selfhosted-3iztigzgmr": {
      "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"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например elvismdev-mem0-mcp-selfhosted-3iztigzgmr.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: elvismdev-mem0-mcp-selfhosted-3iztigzgmr
    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
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "elvismdev-mem0-mcp-selfhosted-3iztigzgmr": {
      "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"
      }
    }
  }
}

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

stevepridemore/graph-memory

stevepridemore/graph-memory

от stevepridemore

Персональный граф знаний для Claude, работающий между сессиями и устройствами. На основе Neo4j и семантических эмбеддингов хранит факты, решения и связи с временной меткой. Полезен разработчикам, и...

TypeScript⭐ 2
penfieldlabs/penfield-mcp

penfieldlabs/penfield-mcp

от penfieldlabs

MCP-сервер Penfield для долговременной памяти AI-агентов. Сохраняет решения, предпочтения и контекст между сессиями, строит граф знаний. Работает с Claude, Cursor, Windsurf и любыми MCP-инструментами.

Dockerfile⭐ 6
mcasdfgf/mcp-roo-memory

mcasdfgf/mcp-roo-memory

от mcasdfgf

MCP-сервер для долговременной графовой памяти AI-агентов. Хранит знания в виде фрактального графа, поддерживает семантический поиск на 50+ языках и управляет контекстным окном через горячие, холодн...

Python⭐ 1
n24q02m/mnemo-mcp

n24q02m/mnemo-mcp

от n24q02m

MCP-сервер для долговременной памяти AI-агентов: гибридный поиск (FTS5 + векторы), временной граф знаний и зашифрованная синхронизация между машинами. Полезен разработчикам, создающим автономных ас...

Python⭐ 12
Cartisien/engram-mcp

Cartisien/engram-mcp

от cartisien

MCP-сервер для постоянной семантической памяти AI-агентов. Хранит воспоминания в SQLite, ищет по смыслу через локальные эмбеддинги Ollama — без облака и API-ключей. Пять инструментов: remember, rec...

TypeScript⭐ 1
mnemoverse/mcp-memory-server

mnemoverse/mcp-memory-server

от mnemoverse

MCP сервер для долговременной памяти AI-агентов, работающий через единый API-ключ в Claude, Cursor, VS Code и ChatGPT. Запоминает факты, предпочтения и уроки между сессиями и проектами. Фидбек улучшает релевантность, а забывание по давности делает память самоочищающейся.

TypeScript⭐ 27
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин