go install github.com/vasayxtx/mcp-prompt-engine@latest

```go
{{ define "_git_commit_role" }}
You are an expert programmer specializing in writing clear, concise, and conventional Git commit messages.
Commit message must strictly follow the Conventional Commits specification.

The final commit message you generate must be formatted exactly as follows:

```
<type>: A brief, imperative-tense summary of changes

[Optional longer description, explaining the "why" of the change. Use dash points for clarity.]
```
{{ if .type -}}
Use {{.type}} as a type.
{{ end }}
{{ end }}
```

{{- /* Commit currently staged changes */ -}}

GXP3

### 3. Validieren Sie Ihren Prompt

Validieren Sie Ihren Prompt, um sicherzustellen, dass er keine Syntaxfehler enthält:

GXP4

### 4. Verbinden Sie den MCP-Server mit Ihrem Client

Fügen Sie den MCP-Server zu Ihrem MCP-Client hinzu. Siehe [Verbindung zu Clients](#connecting-to-clients) für Konfigurationsbeispiele.

### 5. Verwenden Sie Ihren Prompt

Ihr `git_stage_commit`-Prompt ist nun in Ihrem Client verfügbar!

Zum Beispiel können Sie in Claude Desktop den `git_stage_commit`-Prompt auswählen, das `type` MCP-Prompt-Argument angeben und einen generierten Prompt erhalten, der Ihnen hilft, einen Commit mit einer perfekten Nachricht durchzuführen.

In Claude Code oder der Gemini CLI können Sie anfangen, `/git_stage_commit` einzugeben, und es wird der Prompt mit den bereitgestellten Argumenten vorgeschlagen, der nach der Auswahl ausgeführt wird.

***

## Installation

### Vorgefertigte Binärdateien

Laden Sie die neueste Version für Ihr Betriebssystem von der [GitHub Releases-Seite](https://github.com/vasayxtx/mcp-prompt-engine/releases) herunter.

### Aus dem Quellcode erstellen

GXP5

### Docker

Ein vorgefertigtes Docker-Image ist verfügbar. Mounten Sie Ihre lokalen `prompts`- und `logs`-Verzeichnisse in den Container.

GXP6

Sie können das Image auch lokal mit `make docker-build` erstellen.

***

## Verwendung

### Erstellen von Prompt-Vorlagen

Erstellen Sie ein Verzeichnis zum Speichern Ihrer Prompt-Vorlagen. Jede Vorlage sollte eine `.tmpl`-Datei sein, die die [text/template](https://pkg.go.dev/text/template) Syntax von Go verwendet, mit folgendem Format:

GXP7

Der Kommentar in der ersten Zeile (`{{/* description */}}`) wird als Prompt-Beschreibung verwendet, der Rest der Datei ist die Prompt-Vorlage.

Teilvorlagen (Partials) sollten mit einem Unterstrich beginnen (z. B. `_header.tmpl`) und können in anderen Vorlagen mit `{{template "partial_name" .}}` eingebunden werden.

### Template-Syntax

Der Server verwendet die `text/template`-Engine von Go, die leistungsstarke Template-Funktionen bietet:

* **Variablen**: `{{.variable_name}}` - Zugriff auf Template-Variablen
* **Eingebaute Variablen**:
  * `{{.date}}` - Aktuelles Datum und Uhrzeit
* **Bedingungen**: `{{if .condition}}...{{end}}`, `{{if .condition}}...{{else}}...{{end}}`
* **Logische Operatoren**: `{{if and .condition1 .condition2}}...{{end}}`, `{{if or .condition1 .condition2}}...{{end}}`
* **Schleifen**: `{{range .items}}...{{end}}`
* **Template-Einbindung**: `{{template "partial_name" .}}` oder `{{template "partial_name" dict "key" "value"}}`

Weitere Details zur Syntax und den Funktionen finden Sie in der [Go text/template Dokumentation](https://pkg.go.dev/text/template).

### JSON-Argumenten-Parsing

Der Server analysiert Argumentwerte nach Möglichkeit automatisch als JSON, was komplexe Datentypen in Vorlagen ermöglicht:

* **Booleans**: `true`, `false` → Go-Boolean-Werte
* **Zahlen**: `42`, `3.14` → Go-numerische Werte
* **Arrays**: `["item1", "item2"]` → Go-Slices zur Verwendung mit `{{range}}`
* **Objekte**: `{"key": "value"}` → Go-Maps für strukturierte Daten
* **Strings**: Ungültiges JSON wird als String-Wert behandelt

Dies ermöglicht fortgeschrittene Template-Operationen wie:

GXP8

Um das JSON-Parsing zu deaktivieren und alle Argumente als Strings zu behandeln, verwenden Sie das `--disable-json-args`-Flag für die `serve`- und `render`-Befehle.

### CLI-Befehle

Die CLI ist Ihr Hauptwerkzeug zur Verwaltung und zum Testen von Vorlagen.
Standardmäßig sucht sie nach Vorlagen im `./prompts`-Verzeichnis, Sie können jedoch mit dem `--prompts`-Flag ein anderes Verzeichnis angeben.

**1. Vorlagen auflisten**

GXP9

**2. Eine Vorlage rendern**

Renderen Sie einen Prompt direkt in Ihrem Terminal und geben Sie Argumente mit dem `-a` oder `--arg`-Flag an.
Es werden automatisch Umgebungsvariablen als Fallbacks für fehlende Argumente injiziert. Wenn Sie beispielsweise eine Umgebungsvariable `TYPE=fix` haben, wird diese als `{{.type}}` in das Template injiziert.

GXP10

**3. Vorlagen validieren**

Überprüfen Sie alle Ihre Vorlagen auf Syntaxfehler. Der Befehl gibt einen Fehler zurück, wenn eine Vorlage ungültig ist.

GXP11

**4. Den Server starten**

Führen Sie den MCP-Server aus, um Ihre Prompts für Clients verfügbar zu machen.

GXP12

***

## Verbindung zu Clients

Um diese Engine mit einem Client zu verwenden, der MCP-Prompts unterstützt, fügen Sie einen neuen Eintrag zur MCP-Server-Konfiguration hinzu.

Globale Konfigurationspfade (MacOS):

* Claude Code: `~/.claude.json` (`mcpServers`-Abschnitt)
* Claude Desktop: `~/Library/Application\ Support/Claude/claude_desktop_config.json` (`mcpServers`-Abschnitt)
* Gemini CLI: `~/.gemini/settings.json` (`mcpServers`-Abschnitt)

**Beispiel für eine lokale Binärdatei:**

GXP13

**Beispiel für Docker:**

GXP14

## Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert - siehe die [LICENSE](./LICENSE)-Datei für Details.