localmem-mcp-zh

🇨🇳 Локальная, без API, китайская AI-память MCP — SQLite + fastembed с китайской оптимизацией

localmem-mcp-zh даёт любому MCP-совместимому клиенту (Claude Code, Codex, Gemini CLI, Cursor, Windsurf, Cline …) полностью локальную, безоблачную долговременную память. Все воспоминания хранятся в одном файле SQLite, поиск работает через локальное косинусное сходство + китайский FTS5 + взвешенный BM25 с сегментацией jieba — поиск не тратит ни одного токена.

Вдохновлено OpenAgentHQ/localmem-mcp (6 ⭐, создан 2026-08-14), оригинал полностью на английском. Этот репозиторий делает китайскую оптимизацию:

• Сегментация китайского текста через jieba, чтобы избежать сбоев английского токенизатора unicode61 на китайском

• Модель эмбеддингов по умолчанию BAAI/bge-small-zh-v1.5 (SOTA-модель малого размера для китайского поиска)

• Описания инструментов на двух языках — китайском и английском, чтобы китайские агенты лучше понимали намерения

Зачем это нужно

Большинство инструментов AI-памяти (Mem0, Zep, Graphiti) вызывают LLM на этапах хранения и поиска. Этот репозиторий запускает модель эмбеддингов локально всего один раз, после чего всегда офлайн. Помимо конфиденциальности, важнее стоимость: хранение 10 000 воспоминаний и 10 000 поисковых запросов — количество вызовов LLM у localmem-mcp-zh равно 0.

Related MCP server: tartarus-mcp

Установка

pip install localmem-mcp-zh
# 或
uvx localmem-mcp-zh

При первом запуске модель эмбеддингов будет загружена с Hugging Face (около 90 МБ), после чего всё полностью офлайн.

Подключение клиентов

Claude Code / Codex / Gemini CLI

Добавьте следующий фрагмент в конфигурацию MCP (~/.config/mcp/servers.json или файл конфигурации соответствующего клиента):

{
  "mcpServers": {
    "localmem-zh": {
      "command": "uvx",
      "args": ["localmem-mcp-zh"],
      "env": {
        "LOCALMEM_DB": "~/.localmem-mcp-zh/memories.db"
      }
    }
  }
}

Cursor / Windsurf / VS Code

В настройках MCP в IDE добавьте сервер с тем же именем, параметры те же.

Четыре инструмента

Конфиденциальность

Никаких сетевых запросов, кроме однократной загрузки модели эмбеддингов. Удалите ~/.localmem-mcp-zh/memories.db — и воспоминания исчезнут.

Разработка

git clone https://github.com/lvyuan1688/localmem-mcp-zh
cd localmem-mcp-zh
pip install -e ".[dev]"
pytest

Лицензия

MIT — см. LICENSE.