Matthew Hartley Music MCP Server

Matthew Hartley Music — Server MCP

Server MCP pertama yang dimiliki oleh artis. Temukan, narasikan, dan streaming album berkelanjutan yang digerakkan oleh cerita dari dalam klien AI apa pun yang mendukung Model Context Protocol.

Titik akhir langsung (publik, tanpa autentikasi):

https://matthewhartleymusic.com/wp-json/mcp/v1/message

---

Apa ini

Server MCP ini mengekspos The Time Is Now: A Journey in Chapters — album debut Matthew Hartley — sebagai pengalaman terstruktur yang native AI. Dua belas lagu dalam enam bab, masing-masing dengan lirik, narasi emosional, rekaman versi, dan tautan streaming langsung. Dirancang agar klien AI mana pun dapat:

• Menjelajahi katalog — daftar lagu dan bab dengan metadata yang kaya
• Menceritakan kisah di balik setiap lagu — narasi pendek dan lengkap, lirik, tag suasana hati
• Mengkurasi pengalaman mendengarkan yang berurutan — enam mode mendengarkan (late_night, devotional, acoustic_focus, cinematic, quiet_listening, full_journey) dengan arahan adegan untuk presentasi visual
• Streaming audio secara langsung — URL Cloudflare R2 bertanda tangan baru yang dibuat sesuai permintaan, TTL ~4 jam dengan alat penyegaran untuk menjaga pemutaran tanpa gangguan

---

Instalasi cepat

Claude Desktop

Tambahkan ke ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) atau %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "matthew-hartley-music": {
      "type": "http",
      "url": "https://matthewhartleymusic.com/wp-json/mcp/v1/message"
    }
  }
}

Mulai ulang Claude Desktop. Server akan muncul di daftar alat Anda.

Claude Code (CLI)

claude mcp add matthew-hartley-music https://matthewhartleymusic.com/wp-json/mcp/v1/message

Uji koneksi

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"}'

Anda seharusnya mendapatkan kembali JSON yang mencantumkan semua 8 alat.

---

Alat

Alat	Tujuan
list_songs	Daftar semua lagu (filter berdasarkan slug bab atau status rilis)
get_song	Ambil satu lagu berdasarkan ID atau slug — lirik, kutipan, sampul, tautan streaming, penugasan bab
list_chapters	Daftar semua bab dengan angka, nama, rentang tahun, tag suasana hati, jumlah lagu
get_chapter	Ambil satu bab dengan semua lagu dan narasi ACF lengkap
get_artist	Profil artis + konteks biografis
get_experience	Daftar putar terkurasi sekali pakai untuk mode mendengarkan — lagu, adegan, URL streaming baru
get_experience_prompt	Mengembalikan templat prompt narasi yang digunakan agen AI untuk menyelenggarakan sesi mendengarkan
refresh_stream_urls	Buat URL audio bertanda tangan baru secara massal, sebelum URL yang ada kedaluwarsa

Semua alat mengembalikan respons JSON-RPC 2.0. Lagu yang mampu streaming dibatasi streamingnya oleh release_status; narasi bab dibatasi oleh chapter_released.

---

Contoh prompt untuk dicoba

Setelah menginstal, tanyakan kepada Claude:

"Daftarkan lagu-lagu Matthew Hartley dan ceritakan kisah di balik 'Heaven's Calling'."

"Buatkan pengalaman quiet_listening menggunakan alat get_experience. Lalu narasikan seperti pendongeng yang memperkenalkan setiap lagu."

"Apa perjalanan albumnya, bab demi bab?"

"Putarkan Bab VI dan jelaskan apa yang berubah dalam hidupnya selama musim itu."

Alat get_experience adalah panggilan dengan daya ungkit tertinggi — satu permintaan mengembalikan daftar putar yang sepenuhnya berurutan dengan URL streaming dan isyarat adegan visual, siap untuk sesi mendengarkan.

---

Pemutar referensi

Pemutar peramban khusus dibangun langsung di atas MCP ini:

Harmonic Wave Experience Media Player — Pengalaman mendengarkan sinematik yang reaktif terhadap audio dengan sulih suara DJ, hamparan lirik yang disinkronkan dengan LRC, dan palet visual per lagu. Tidak perlu menginstal apa pun — cukup buka dan dengarkan.

---

Arsitektur

┌─────────────────────────────┐
│  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 menghosting katalog (tipe pos kustom song dan artist, taksonomi chapter, bidang ACF untuk lirik/cerita/tautan streaming)
• File audio berada di bucket Cloudflare R2 pribadi, diakses melalui URL prabayar AWS Sig V4 yang dibuat sesuai permintaan
• Titik akhir MCP sepenuhnya publik — tidak diperlukan autentikasi. Streaming per lagu dibatasi di sisi server berdasarkan status rilis.

---

Tentang Matthew Hartley

Matthew Hartley adalah penulis lagu rock Kristen dari Sarasota, FL — dan veteran industri perangkat lunak selama lebih dari 25 tahun yang kariernya mencakup rekayasa, arsitektur, penjualan, dan kepemimpinan eksekutif, dengan beberapa pengajuan paten USPTO atas namanya. Ia memimpin Imagine Peak Studios, studio di balik MCP ini dan platform Harmonic Wave. The Time Is Now: A Journey in Chapters adalah album dua belas lagu yang ditulis selama dua puluh lima tahun (1999–2026) — enam bab yang menelusuri kepolosan dan patah hati, kebangkitan, memutus siklus, cinta dan komitmen, keruntuhan dan panggilan, serta iman yang membumi.

• Situs web: matthewhartleymusic.com
• Pemutar pengalaman: experience.matthewhartleymusic.com
• Spotify, Apple Music, YouTube, SoundCloud: semua tertaut per lagu dalam respons MCP

---

Didukung oleh Harmonic Wave

Server ini dibangun di atas platform Harmonic Wave — untuk kreator konten yang membuat karya mereka native AI.

Platform ini juga menyertakan plugin Harmonic Wave untuk Claude Code yang mengubah prompt menjadi pemutar media kustom untuk katalog di platform.

---

Lisensi

Dokumentasi dalam repositori ini dilisensikan di bawah Lisensi Apache 2.0. Kode sumber mu-plugin WordPress server MCP adalah hak milik dan tidak disertakan dalam repositori ini. Musik, lirik, konten cerita, dan rekaman audio yang diekspos oleh MCP adalah © Imagine Peak Studios — semua hak dilindungi undang-undang.