Skip to main content
Glama

@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 tsc-Typenprüfungen und Jest-Tests innerhalb des MCP-Clients

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-config

Schnellstart

1. MCP-Server installieren

npm install -g @mempalace/mcp-dev

Oder verwenden Sie ihn ohne Installation via npx:

npx @mempalace/mcp-dev

2. 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 installed

3. Codebase indizieren

mempalace --palace ~/.mempalace/active mine /path/to/your/repo --wing code --mode projects

4. 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

MCP_REPO_DIR

process.cwd()

Absoluter Pfad zu Ihrem Git-Repository-Root

MCP_PALACE_DIR

~/.mempalace/active

MemPalace-Datenverzeichnis

MCP_PALACE_WING

code

Wing-Name (Namespace) innerhalb des Palace

MCP_LEDGER_PATH

<repo>/.mcp-dev/ledger.jsonl

Pfad zur Änderungsprotokolldatei

MCP_TRACKS_DIR

<repo>/conductor/tracks

Verzeichnis mit Project-Track-Ordnern

MEMPALACE_PYTHON

python3

Python-Binary (muss mempalace installiert haben)


MCP-Tools-Referenz

Codesuche

Tool

Beschreibung

search_code

Semantische Suche über die indizierte Codebase. Akzeptiert query (String) sowie optional scope (Raumname) und limit (Int, Standard 10)

mine_changed_files

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

get_branch_context

Gibt den aktuellen Branch, SHA, kurzen SHA und die letzten 5 Commit-Nachrichten zurück

get_changed_files

Dateien, die gegenüber HEAD~1 (oder einer angegebenen Basis-Referenz) geändert wurden, mit Status Hinzufügen/Ändern/Löschen

get_git_diff

Vollständige Diff-Ausgabe. Optionale base-Referenz und filePath zur Eingrenzung

Änderungsprotokoll

Tool

Beschreibung

record_change

Einen Eintrag an das Protokoll anhängen (betroffene Dateien, Beschreibung, Grund, Tags, optionaler Track-Link)

read_ledger

Aktuelle Protokolleinträge lesen. Optionales limit (Standard 20) und branch-Filter

Dev-Lifecycle

Tool

Beschreibung

run_typecheck

Führt tsc --noEmit in einem Service-Verzeichnis aus. Gibt strukturierte Fehler mit Datei/Zeile/Spalte/Code zurück

run_tests

Führt Jest in einem Service-Verzeichnis aus. Gibt Anzahl der bestandenen/fehlgeschlagenen Tests und strukturierte Fehlerdetails zurück

Project Tracks (Conductor)

Tool

Beschreibung

list_tracks

Alle aktiven Tracks auflisten (Verzeichnisse mit plan.md)

get_track_plan

plan.md für einen Track lesen

update_track_plan

plan.md für einen Track überschreiben

get_track_spec

spec.md für einen Track lesen

update_track_spec

spec.md für einen Track überschreiben

get_track_index

index.md für einen Track lesen

update_track_index

index.md für einen Track überschreiben

create_track

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.md enthält.

  • plan.md wird 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 mit MCP_PALACE_WING übereinstimmen

  • exclude_patterns – Muster in Gitignore-Syntax, die beim Mining übersprungen werden sollen

  • rooms – 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 test

Siehe CONTRIBUTING.md für Richtlinien zur Mitarbeit.


Lizenz

MIT – siehe LICENSE.

Install Server
A
license - permissive license
A
quality
C
maintenance

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