Matthew Hartley Music MCP Server
offiziellDer erste Künstler-eigene MCP-Server für die Nutzung durch KI-Agenten. Entdecken, erzählen und streamen Sie Matthew Hartleys Debütalbum The Time Is Now: A Journey in Chapters von jedem KI-Client aus. Angetrieben von Harmonic Wave.
Dokumentation
Matthew Hartley Music — MCP-Server
Der erste von einem Künstler betriebene MCP-Server. Entdecken, erzählen und streamen Sie ein fortlaufendes, geschichtengetriebenes Album direkt aus jedem KI-Client, der das Model Context Protocol spricht.
Live-Endpunkt (öffentlich, keine Authentifizierung):
https://matthewhartleymusic.com/wp-json/mcp/v1/message
Was es ist
Dieser MCP-Server stellt The Time Is Now: A Journey in Chapters – Matthew Hartleys Debütalbum – als strukturierte, KI-native Erfahrung bereit. Zwölf Songs in sechs Kapiteln, jeweils mit Texten, emotionaler Erzählung, Versionen-Aufnahmen und direkten Streaming-Links. Entwickelt, damit jeder KI-Client:
- Den Katalog entdecken – Songs und Kapitel mit umfangreichen Metadaten auflisten
- Die Geschichte hinter jedem Song erzählen – kurze und vollständige Erzählungen, Texte, Stimmungstags
- Ein sequenziertes Hörerlebnis kuratieren – sechs Hörmodi (
late_night,devotional,acoustic_focus,cinematic,quiet_listening,full_journey) mit Szenenanweisungen für die visuelle Präsentation - Audio direkt streamen – frische signierte Cloudflare R2-URLs, die bei Bedarf erstellt werden, ~4 Stunden TTL mit einem Aktualisierungstool, um die Wiedergabe unterbrechungsfrei zu halten
Schnellinstallation
Claude Desktop
Zu ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows) hinzufügen:
{
"mcpServers": {
"matthew-hartley-music": {
"type": "http",
"url": "https://matthewhartleymusic.com/wp-json/mcp/v1/message"
}
}
}
Claude Desktop neu starten. Der Server erscheint in Ihrer Tool-Liste.
Claude Code (CLI)
claude mcp add matthew-hartley-music https://matthewhartleymusic.com/wp-json/mcp/v1/message
Verbindung testen
curl -X POST https://matthewhartleymusic.com/wp-json/mcp/v1/message \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Sie sollten JSON mit allen 8 Tools zurückbekommen.
Tools
| Tool | Zweck |
|---|---|
list_songs | Alle Songs auflisten (Filter nach Kapitel-Slug oder Veröffentlichungsstatus) |
get_song | Einen Song nach ID oder Slug abrufen – Texte, Zitate, Cover-Art, Streaming-Links, Kapitelzuordnung |
list_chapters | Alle Kapitel mit Nummer, Name, Jahresbereich, Stimmungstags, Songanzahl auflisten |
get_chapter | Ein Kapitel mit allen Songs und vollständiger ACF-Erzählung abrufen |
get_artist | Künstlerprofil + biografischer Kontext |
get_experience | Kuratierte One-Shot-Playlist für einen Hörmodus – Songs, Szenen, frische Stream-URLs |
get_experience_prompt | Gibt die Erzähl-Prompt-Vorlage zurück, die KI-Agenten verwenden, um Hörsitzungen zu moderieren |
refresh_stream_urls | Frische signierte Audio-URLs in großen Mengen erstellen, bevor bestehende URLs ablaufen |
Alle Tools geben JSON-RPC 2.0-Antworten zurück. Streaming-fähige Songs werden durch release_status gesteuert; Kapitelerzählungen durch chapter_released.
Beispiel-Prompts zum Ausprobieren
Fragen Sie Claude nach der Installation:
"Liste Matthew Hartleys Songs auf und erzähle mir die Geschichte hinter 'Heaven's Calling'."
"Erstelle mir ein quiet_listening-Erlebnis mit dem get_experience-Tool. Erzähle es dann wie ein Geschichtenerzähler, der jeden Song einführt."
"Was ist die Reise seines Albums, Kapitel für Kapitel?"
"Spiele mir Kapitel VI und erkläre, was sich in dieser Lebensphase für ihn verändert hat."
Das get_experience-Tool ist der wirkungsvollste Aufruf – eine Anfrage liefert eine vollständig sequenzierte Playlist mit Stream-URLs und visuellen Szenenhinweisen, bereit für eine Hörsitzung.
Der Referenz-Player
Ein dedizierter Browser-Player basiert direkt auf diesem MCP:
Harmonic Wave Experience Media Player – Ein filmreifes, audio-reaktives Hörerlebnis mit DJ-Sprachüberblendungen, LRC-synchronisierten Texteinblendungen und visuellen Paletten pro Song. Nichts zu installieren – einfach öffnen und zuhören.
Architektur
┌─────────────────────────────┐
│ Any AI client (Claude, │
│ ChatGPT, Cursor, etc.) │
└────────────┬────────────────┘
│ JSON-RPC over HTTP
▼
┌─────────────────────────────┐
│ matthewhartleymusic.com │
│ /wp-json/mcp/v1/message │
│ (WordPress mu-plugin) │
└────────────┬────────────────┘
│ signs URLs at request time
▼
┌─────────────────────────────┐
│ Cloudflare R2 │
│ (private bucket — signed │
│ URLs only, 4-hour TTL) │
└─────────────────────────────┘
- WordPress hostet den Katalog (benutzerdefinierte Post-Typen
songundartist, Taxonomiechapter, ACF-Felder für Texte/Geschichten/Streaming-Links) - Audiodateien befinden sich in einem privaten Cloudflare R2-Bucket, Zugriff über AWS Sig V4 vorab signierte URLs, die bei Bedarf erstellt werden
- Der MCP-Endpunkt ist vollständig öffentlich – keine Authentifizierung erforderlich. Das Streaming pro Song wird serverseitig durch den Veröffentlichungsstatus gesteuert.
Über Matthew Hartley
Matthew Hartley ist ein christlicher Rocksongwriter aus Sarasota, FL – und ein Veteran der Softwarebranche mit über 25 Jahren Erfahrung, dessen Karriere Ingenieurwesen, Architektur, Vertrieb und Führungspositionen umfasst, mit mehreren USPTO-Patentanmeldungen auf seinen Namen. Er leitet Imagine Peak Studios, das Studio hinter diesem MCP und der Harmonic Wave-Plattform. The Time Is Now: A Journey in Chapters ist ein zwölf Songs umfassendes Album, geschrieben über fünfundzwanzig Jahre (1999–2026) – sechs Kapitel, die Unschuld und Herzschmerz, Erwachen, den Kreislauf durchbrechen, Liebe und Hingabe, Zusammenbruch und Berufung sowie geerdeten Glauben nachzeichnen.
- Website: matthewhartleymusic.com
- Experience-Player: experience.matthewhartleymusic.com
- Spotify, Apple Music, YouTube, SoundCloud: alle pro Song in den MCP-Antworten verlinkt
Powered by Harmonic Wave
Dieser Server basiert auf der Harmonic Wave-Plattform – für Content-Ersteller, die ihre Arbeit KI-nativ machen.
Die Plattform umfasst auch ein Harmonic Wave-Plugin für Claude Code, das Prompts in benutzerdefinierte Mediaplayer für Kataloge auf der Plattform verwandelt.
Lizenz
Die Dokumentation in diesem Repository ist unter der Apache License 2.0 lizenziert. Der Quellcode des WordPress mu-Plugins des MCP-Servers ist proprietär und nicht in diesem Repository enthalten. Die Musik, Texte, Geschichteninhalte und Audioaufnahmen, die vom MCP bereitgestellt werden, sind © Imagine Peak Studios – alle Rechte vorbehalten.