mcp-memories

MCP-сервер, который захватывает сессии сборки кода и публикует их в общую базу знаний команды, делая прошлую работу доступной через семантический поиск.

Что он делает:

• Автоматически захватывает каждую сессию агента через IDE-хуки (Cursor, Claude Code)

• Когда вы вызываете complete_session, он подводит итоги с помощью Grove AI и создает эмбеддинги с Voyage voyage-code-4

• Члены команды ищут на естественном языке — векторный поиск + реранжировка Voyage возвращает наиболее релевантные прошлые сборки

Настройка

1. Установка и сборка

npm install
npm run build

2. Настройка окружения

cp .env.example .env
# Fill in MONGODB_URI, MDB_GROVE_API_KEY, GROVE_BASE_URL, VOYAGE_API_KEY, MEMORIES_AUTHOR

3. Регистрация MCP-сервера

Добавьте в конфигурацию MCP вашей IDE (например, ~/.cursor/mcp.json или config.json Claude Desktop):

{
  "mcpServers": {
    "mcp-memories": {
      "command": "node",
      "args": ["/path/to/mcp-memories/dist/index.js"],
      "env": {
        "MONGODB_URI": "mongodb+srv://...",
        "MEMORIES_DB": "mcp_memories",
        "MDB_GROVE_API_KEY": "...",
        "GROVE_BASE_URL": "...",
        "GROVE_MODEL": "claude-3-7-sonnet",
        "VOYAGE_API_KEY": "...",
        "MEMORIES_AUTHOR": "your.name"
      }
    }
  }
}

4. Настройка хуков автозахвата

Cursor — hooks.json уже находится в .cursor/hooks.json. Он автоматически запускает скрипт захвата при каждом событии stop.

Claude Code — объедините фрагмент из hooks/claude/settings-snippet.json в ваш ~/.claude/settings.json, обновив путь, чтобы он указывал на этот репозиторий.

Related MCP server: Concept Tracker

Инструменты

Типичный рабочий процесс

# During a session — automatic (hook fires) or manual:
capture_activity(session_id="abc123", conversation_context="Built JWT auth middleware...")

# When done:
complete_session(session_id="abc123", final_notes="Ended up using RS256 instead of HS256 because...")

# Later, someone else starting similar work:
search_memories(query="JWT authentication middleware Node.js")

Настройка MongoDB Atlas

Сервер создает свои собственные индексы при запуске, включая индекс векторного поиска Atlas (memories_vector_index, 1024 измерения, косинусное сходство, voyage-code-4). Вам нужен кластер Atlas с включенным векторным поиском.