Problematic-paratroops563/16bits-audio-mcp

Was macht 16bits-audio-mcp?

Erzeuge loopbare Spiel-Audio als 16-Bit-PCM-WAV-Dateien mit einem Zig-MCP-Server und deterministischer, seed-basierter Ausgabe.

Überblick

Dieser MCP-Server generiert loopbare Spiel-Audiodateien im 16-Bit-PCM-WAV-Format. Die Ausgabe ist vollkommen deterministisch: Derselbe Seed liefert immer identische Audiodaten. Das macht ihn ideal für prozedurale Soundeffekte, Hintergrundmusik oder Sounddesign in Spielen.

Voraussetzungen

• Zig (z. B. Version 0.13.0 oder neuer) muss installiert sein.
• Ein MCP-kompatibler Client (wie Claude Code, Cursor, Codex) für die Steuerung.

Installation

1. Klone das Repository:

   git clone https://github.com/Problematic-paratroops563/16bits-audio-mcp.git
   cd 16bits-audio-mcp
   

2. Baue den Server:

   zig build
   

3. Starte den Server:

   ./zig-out/bin/16bits-audio-mcp
   

   Der Server lauscht standardmäßig auf localhost:9090.

Verwendung

Der Server implementiert das MCP-Protokoll. Ein Client sendet einen JSON-RPC-Aufruf mit folgendem Format:

Request:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "generate_audio",
  "params": {
    "seed": 42,
    "length_seconds": 2.0,
    "genre": "chiptune"
  }
}

Response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "file": "/path/to/output.wav",
    "sample_rate": 44100,
    "bits_per_sample": 16,
    "channels": 1,
    "duration_seconds": 2.0
  }
}

Parameter

Parameter	Typ	Standardwert	Beschreibung
seed	integer	0	Seed für die deterministische Generierung
length_seconds	float	1.0	Dauer in Sekunden
genre	string	"chiptune"	Musikgenre (z. B. "chiptune", "ambient", "8bit")

Beispiele

Genre: "chiptune", Seed: 123, Länge: 3.5 Sekunden → looper 8-Bit-Sound. Genre: "ambient", Seed: 456, Länge: 5.0 Sekunden → ruhiger Pad-Sound.

Entwicklung

Zum Bearbeiten des Quellcodes öffne src/main.zig. Das Skript zig build erstellt das Projekt.

Lizenz

MIT