@mempalace/mcp-dev
@mempalace/mcp-dev
Ein MCP-Server (Model Context Protocol), der KI-Coding-Assistenten fundierten, branch-bezogenen Kontext über Ihre Codebase liefert. Er bietet semantische Codesuche via MemPalace, Git-Änderungsverfolgung, ein persistentes Änderungsprotokoll, TypeScript/Jest-Entwicklungs-Lifecycle-Tools und eine integrierte Project Tracks (Conductor)-Methodik für strukturierte Feature-Arbeit.
Funktionen
Funktion | Beschreibung |
Semantische Codesuche | Natürlichsprachliche Abfragen über Ihre indizierte Codebase via MemPalace-Embeddings |
Branch-Kontext | Aktueller Branch, SHA, letzte Commits – immer orientiert |
Änderungsprotokoll | Nur-Anhängen-JSONL-Log jeder KI-gestützten Änderung mit vollständiger Herkunft |
Dev-Lifecycle | Ausführen von |
Git-Diff | Vollständige oder dateibezogene Diff-Ausgabe |
Project Tracks | Erstellen und Verwalten von Markdown-basierten Feature-Tracks (Plan/Spec/Index/Metadaten) |
Voraussetzungen
Node.js ≥ 18
Python ≥ 3.9 mit installiertem MemPalace
Ein Git-Repository, auf das verwiesen werden soll
MemPalace installieren
pip install mempalace
# or from the fork with exclude-patterns support:
pip install git+https://github.com/2loch-ness6/mempalace@feat/exclude-patterns-configSchnellstart
1. MCP-Server installieren
npm install -g @mempalace/mcp-devOder verwenden Sie ihn ohne Installation via npx:
npx @mempalace/mcp-dev2. Umgebungsvariablen konfigurieren
export MCP_REPO_DIR=/path/to/your/repo # defaults to process.cwd()
export MCP_PALACE_DIR=~/.mempalace/active # MemPalace data directory
export MCP_PALACE_WING=code # wing name (namespace) for your repo
export MEMPALACE_PYTHON=python3 # python binary with mempalace installed3. Codebase indizieren
mempalace --palace ~/.mempalace/active mine /path/to/your/repo --wing code --mode projects4. Zur MCP-Client-Konfiguration hinzufügen
Für Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"mempalace-mcp-dev": {
"command": "npx",
"args": ["@mempalace/mcp-dev"],
"env": {
"MCP_REPO_DIR": "/path/to/your/repo",
"MCP_PALACE_DIR": "/home/you/.mempalace/active",
"MCP_PALACE_WING": "code",
"MEMPALACE_PYTHON": "python3"
}
}
}
}Umgebungsvariablen
Variable | Standard | Beschreibung |
|
| Absoluter Pfad zu Ihrem Git-Repository-Root |
|
| MemPalace-Datenverzeichnis |
|
| Wing-Name (Namespace) innerhalb des Palace |
|
| Pfad zur Änderungsprotokolldatei |
|
| Verzeichnis mit Project-Track-Ordnern |
|
| Python-Binary (muss |
MCP-Tools-Referenz
Codesuche
Tool | Beschreibung |
| Semantische Suche über die indizierte Codebase. Akzeptiert |
| Re-Indizierung von Dateien, die seit dem letzten Git-Commit geändert wurden. Nach dem Bearbeiten aufrufen, um die Suche aktuell zu halten |
Branch & Git
Tool | Beschreibung |
| Gibt den aktuellen Branch, SHA, kurzen SHA und die letzten 5 Commit-Nachrichten zurück |
| Dateien, die gegenüber |
| Vollständige Diff-Ausgabe. Optionale |
Änderungsprotokoll
Tool | Beschreibung |
| Einen Eintrag an das Protokoll anhängen (betroffene Dateien, Beschreibung, Grund, Tags, optionaler Track-Link) |
| Aktuelle Protokolleinträge lesen. Optionales |
Dev-Lifecycle
Tool | Beschreibung |
| Führt |
| Führt Jest in einem Service-Verzeichnis aus. Gibt Anzahl der bestandenen/fehlgeschlagenen Tests und strukturierte Fehlerdetails zurück |
Project Tracks (Conductor)
Tool | Beschreibung |
| Alle aktiven Tracks auflisten (Verzeichnisse mit |
|
|
|
|
|
|
|
|
|
|
|
|
| Ein neues Track-Verzeichnis mit allen vier Dateien erstellen |
Project Tracks Methodik (Conductor)
Project Tracks ist ein leichtgewichtiges, dateibasiertes Feature-Verwaltungssystem. Jeder Track ist ein Verzeichnis, das bis zu vier Dateien enthält:
conductor/tracks/
└── my-feature-20260501/
├── plan.md ← living task list; the status source of truth
├── spec.md ← technical spec, design decisions, acceptance criteria
├── index.md ← short summary and linked resources
└── metadata.json ← machine-readable metadata (id, owner, status, dates)Regeln:
Ein Verzeichnis ist nur dann ein aktiver Track, wenn es
plan.mdenthält.plan.mdwird immer live von der Festplatte gelesen/geschrieben (niemals via MemPalace – keine Veraltung).Track-Slugs müssen
[a-zA-Z0-9][a-zA-Z0-9_-]*entsprechen (max. 100 Zeichen).
Bootstrapping von Tracks in einem neuen Projekt:
# Create the tracks directory
mkdir -p conductor/tracks
# Use the MCP tool to scaffold a track
# (or copy from templates/track/ in this package)Vorlagendateien sind in templates/track/ für manuelles Scaffolding enthalten.
MemPalace-Konfiguration (mempalace.yaml)
Platzieren Sie eine mempalace.yaml im Root von MCP_REPO_DIR, um zu steuern, wie Dateien indiziert werden. Ein generisches Beispiel finden Sie in mempalace.yaml.example.
Wichtige Abschnitte:
wing– muss mitMCP_PALACE_WINGübereinstimmenexclude_patterns– Muster in Gitignore-Syntax, die beim Mining übersprungen werden sollenrooms– semantische Routing-Regeln (Schlüsselwort → Raumname) für die Such-Eingrenzung
Entwicklung
git clone https://github.com/your-org/mempalace-mcp-dev
cd mempalace-mcp-dev
npm install
npm run build
npm testSiehe CONTRIBUTING.md für Richtlinien zur Mitarbeit.
Lizenz
MIT – siehe LICENSE.
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/2loch-ness6/mempalace-mcp-dev'
If you have feedback or need assistance with the MCP directory API, please join our Discord server