mcp-memories

Ein MCP-Server, der Code-Build-Sitzungen erfasst und in einer gemeinsamen Team-Wissensdatenbank veröffentlicht, sodass vergangene Arbeiten per semantischer Suche auffindbar sind.

Was er macht:

• Automatische Erfassung jeder Agentensitzung über IDE-Hooks (Cursor, Claude Code)

• Wenn du complete_session aufrufst, fasst er mit Grove AI zusammen und bettet mit Voyage voyage-code-4 ein

• Teammitglieder suchen mit natürlicher Sprache – Vektorsuche + Voyage-Reranking liefern die relevantesten vergangenen Builds

Einrichtung

1. Installieren und bauen

npm install
npm run build

2. Umgebung konfigurieren

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

3. MCP-Server registrieren

Füge die MCP-Konfiguration deiner IDE hinzu (z. B. ~/.cursor/mcp.json oder Claude Desktop config.json):

{
  "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. Auto-Capture-Hooks einrichten

Cursor – hooks.json befindet sich bereits in .cursor/hooks.json. Es feuert das Erfassungsskript bei jedem stop-Ereignis automatisch aus.

Claude Code – füge den Ausschnitt in hooks/claude/settings-snippet.json in deine ~/.claude/settings.json ein und aktualisiere den Pfad, sodass er auf dieses Repository verweist.

Related MCP server: Concept Tracker

Tools

Typischer Arbeitsablauf

# 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 Einrichtung

Der Server erstellt beim Start seine eigenen Indizes, einschließlich des Atlas Vector Search Index (memories_vector_index, 1024 Dimensionen, Kosinus-Ähnlichkeit, voyage-code-4). Du benötigst einen Atlas-Cluster mit aktivierter Vektorsuche.