Легкий, локально-первый постоянный сервер памяти для инструментов ИИ. Хранит записи структурированной памяти в SQLite и раскрывает их как по протоколу Model Context Protocol (MCP), так и по простому REST HTTP API. Поставляется с интерфейсом React для просмотра и управления воспоминаниями в браузере.

Что он делает

• Персистирование названных записей памяти (титул + содержание + теги) в локальной базе данных SQLite Полнотекстовый поиск по SQLite FTS5 (префиксные запросы, цитируемые фразы, отрицательные фильтры)

• Фильтрация на основе тегов с конвенцией namespace:value (например, project:myapp, lang:typescript)

• Отображает воспоминания клиентов ИИ через MCP stdio или MCP Streamable HTTP Также служит простой REST API для прямого доступа HTTP. Включает интерфейс браузера React 19 для визуального управления

Структура проекта

Предпосылки

Node.js >= 20

##Установка

Запуск сервера

HTTP режим (REST API + MCP Streamable HTTP)

Сервер запускается в порту 5172**.

• Проверка здоровья: [[Т3]]
• REST API: http://localhost:5172/api/memories MCP Streamable HTTP: http://localhost:5172/mcp

stdio mode (MCP stdio — для Claude Desktop / Claude CLI)

Mini Memory MCP

A lightweight, local-first persistent memory server for AI tools. Stores structured memory entries in SQLite and exposes them over both the Model Context Protocol (MCP) and a plain REST HTTP API. Comes with a React UI for browsing and managing memories in the browser.

---

What it does

• Persists named memory entries (title + content + tags) in a local SQLite database
• Full-text search via SQLite FTS5 (prefix queries, quoted phrases, negative filters)
• Tag-based filtering with namespace:value convention (e.g. project:myapp, lang:typescript)
• Exposes memories to AI clients over MCP stdio or MCP Streamable HTTP
• Also serves a plain REST API for direct HTTP access
• Includes a React 19 browser UI for visual management

---

Project structure

mini-memory-mcp/
├── server/
│   ├── index.ts          # Entry point — stdio or HTTP mode
│   ├── db.ts             # SQLite init, WAL, FTS5 schema & triggers
│   ├── memory-store.ts   # CRUD + FTS search logic
│   ├── routes.ts         # Express REST router (/api/memories)
│   └── mcp-tools.ts      # MCP tool definitions (memory_list/create/read/update/delete/search)
├── ui/
│   └── src/
│       ├── api.ts                    # Typed fetch helpers
│       ├── hooks/useMemories.ts      # State, debounced search, CRUD
│       └── components/               # MemoryList, MemoryCard, MemoryForm, SearchBar
├── data/
│   └── mini-memory.sqlite            # Auto-created on first run
└── package.json

---

Prerequisites

• Node.js >= 20

---

Installation

# Install server dependencies
npm install

# Install UI dependencies
cd ui && npm install

---

Running the server

HTTP mode (REST API + MCP Streamable HTTP)

npm start

Server starts on port 5172.

• Health check: GET http://localhost:5172/
• REST API: http://localhost:5172/api/memories
• MCP Streamable HTTP: http://localhost:5172/mcp

stdio mode (MCP stdio — for Claude Desktop / Claude CLI)

npm run start:mcp

The process speaks the MCP protocol over stdin/stdout. No HTTP server is started.

---

Running the UI

With the HTTP server already running:

cd ui
npm run dev

UI starts on port 5173 and proxies /api requests to the server on port 5172.

Open http://localhost:5173 in your browser.

---

Connecting via MCP

stdio (Claude Desktop)

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "mini-memory-mcp": {
      "command": "npx",
      "args": ["tsx", "/absolute/path/to/mini-memory-mcp/server/index.ts", "--stdio"]
    }
  }
}

Or with npm run start:mcp:

{
  "mcpServers": {
    "mini-memory-mcp": {
      "command": "npm",
      "args": ["run", "start:mcp"],
      "cwd": "/absolute/path/to/mini-memory-mcp"
    }
  }
}

stdio (Claude Code CLI)

claude mcp add mini-memory-mcp -- npx tsx /absolute/path/to/mini-memory-mcp/server/index.ts --stdio