Skip to main content
Glama
lvyuan1688

localmem-mcp-zh

by lvyuan1688

localmem-mcp-zh

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

Demo

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 добавьте сервер с тем же именем, параметры те же.

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

Инструмент

Назначение

store_memory

Сохранить постоянное воспоминание — решения, предпочтения, факты, можно с тегами

search_memory

Искать по смыслу. «Какая база данных?» найдёт «мы выбрали SQLite»

recall_memory

Перечитать воспоминание по id или получить последние несколько

memory_stats

Где находится база данных, сколько записей хранится

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

Никаких сетевых запросов, кроме однократной загрузки модели эмбеддингов. Удалите ~/.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.

Maintenance

ActivitySlowing
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    C
    maintenance
    A local, fully-offline MCP memory server that enables persistent storage and retrieval of information using SQLite with both keyword and semantic vector search capabilities.
    10
    22 npm
    13
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    A local-first MCP memory server providing persistent, searchable memory for AI agents, powered by SQLite.
    1 npm
    1
    Apache 2.0
  • A
    license
    Not graded
    quality
    B
    maintenance
    Local-first AI Memory MCP server for AI agents to search and manage knowledge stored in Obsidian vaults, optimized for CJK languages with zero AI dependency.
    2
    MIT