Promem-MCP

Project Memory MCP — persistenter Projektkontext für KI-Coding-Agenten. Entwickelt von DIP-RO.

pip install promem-mcp

Keine Datenbank. Keine Cloud. Kein Daemon. Kein manuelles Speichermanagement.

ContextMCP ist eine lokale, MCP-native Context-Runtime, die KI-Coding-Agenten ein dauerhaftes Projektverständnis bietet — Architektur, Regeln, Entscheidungen, Konventionen, Umgebungsintelligenz und Git-Kontext — ohne wiederholte Erklärungen oder Kontextverschwendung.

Schnellstart

pip install promem-mcp

Dann registrieren Sie ContextMCP bei Ihrem KI-Coding-Client:

# See which clients are detected
promem config

# Auto-configure a specific client (with backup + merge)
promem config cursor
promem config claude-code
promem config claude-desktop
promem config vscode

Oder fügen Sie es manuell zur MCP-Konfiguration Ihres Clients hinzu:

{
  "mcpServers": {
    "contextmcp": {
      "command": "contextmcp",
      "args": []
    }
  }
}

VS Code-Hinweis: VS Code verwendet den Schlüssel "servers", nicht "mcpServers". Führen Sie promem config vscode für das korrekte Format aus.

Das war's. Ihr KI-Coding-Agent hat jetzt dauerhaften Projektkontext.

Funktionsweise

Funktionen

• Null-Einrichtungsspeicher — SQLite-Datenbank wird automatisch im betriebssystemgerechten Verzeichnis erstellt

• Automatische Projekterkennung — Sprache, Framework, Paketmanager, Testframework

• Dauerhafter Speicher — Regeln, Entscheidungen, Konventionen, Umgebungsfakten, Git-Intelligenz

• Token-effizienter Abruf — FTS5-Suche mit Token-Budget, gibt nur relevanten Kontext zurück

• Herkunftsverfolgung — jeder Speicher weiß, woher er kommt und wie sicher er ist

• Geheimnis-Schwärzung — API-Schlüssel, Token, Passwörter werden nie gespeichert oder zurückgegeben

• Projektisolierung — Projektspeicher gelangen nie zwischen Projekten

• Erkennung veralteten Kontexts — markiert Speicher, die mit dem aktuellen Projektstatus in Konflikt stehen

• Widerspruchserkennung — identifiziert widersprüchliche Projektregeln

• Sitzungskontinuität — Übergabe-Zusammenfassungen für Wechsel zwischen Agenten/Sitzungen

• Git-Intelligenz — letzte Commits, geänderte Dateien, TODOs/FIXMEs

• Umgebungsdiagnose — Python-Version, venv, .env-Vollständigkeit, Docker

• Lokal zuerst — keine Netzwerkanfragen, keine Cloud, keine externen Dienste

MCP-Tools

CLI

contextmcp --version        # Version
promem status           # Project + storage status
promem doctor           # Health checks
promem stats            # Usage statistics
promem search "query"   # Search context
promem memory list      # List memories
promem decision "text"  # Save a decision
promem privacy          # Privacy info
promem config           # Client configuration
promem repair           # Rebuild index, optimize DB
promem reset            # Delete all data (with confirmation)

Client-Unterstützung

Kein Client unterstützt eine echte Null-Konfigurations-Autoregistrierung. ContextMCP erkennt installierte Clients, bietet an, die Konfiguration zu schreiben (mit Backup + Merge) und liefert exakte Copy-Paste-Schnipsel.

Datenschutz

• Nur lokal — keine Netzwerkanfragen

• Projektinhalte werden nicht hochgeladen

• Geheimnisse werden geschwärzt — nie gespeichert oder zurückgegeben

• Keine Cloud-Abhängigkeiten

promem privacy

Speicherort

ContextMCP verwendet projektlokalen Speicher — kein zentrales OS-Verzeichnis, keine Speicherverschwendung.

Jedes Projekt erhält eine eigene .contextmcp/contextmcp.db. Der Speicher reist mit dem Projekt. Keine globale Speicherplatzaufblähung.

Fügen Sie .contextmcp/ zu Ihrer .gitignore hinzu (bereits standardmäßig in ContextMCPs Ignorier-Mustern enthalten).

Überschreiben Sie dies bei Bedarf mit der Umgebungsvariable CONTEXTMCP_DATA_DIR.

Installation

# pip
pip install promem-mcp

# uv
uv add contextmcp

# pipx (global CLI)
pipx install contextmcp

Funktioniert in venv, virtualenv, uv, pipx und systemweitem Python.

Entwicklung

git clone https://github.com/contextmcp/contextmcp.git
cd contextmcp
pip install -e ".[dev]"
pytest

Lizenz

MIT