Matthew Hartley Music

Matthew Hartley Music — MCP 服务

首个由艺人拥有的 MCP 服务。 在任何支持 Model Context Protocol 的 AI 客户端中，探索、讲述并流媒体播放一张连续、以故事为主线的专辑。

在线端点（公开，无需身份验证）：

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

---

简介

此 MCP 服务将 Matthew Hartley 的首张专辑 The Time Is Now: A Journey in Chapters 打造为结构化、原生面向 AI 的体验。专辑包含六个篇章、十二首歌曲，每首歌都附有歌词、情感叙事、不同版本的录音和直接流媒体链接。其设计旨在让任何 AI 客户端都能：

• 探索曲目目录 — 查看歌曲和篇章列表及丰富的元数据
• 讲述每首歌背后的故事 — 简短和完整的叙事、歌词、情绪标签
• 策划按顺序播放的聆听体验 — 六种聆听模式（late_night、devotional、acoustic_focus、cinematic、quiet_listening、full_journey），并附带用于视觉呈现的场景指示
• 直接流媒体播放音频 — 按需生成新的 Cloudflare R2 签名 URL，有效期约为 4 小时，并可通过刷新工具保持播放不中断

---

快速安装

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

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

重启 Claude Desktop。该服务将显示在工具列表中。

Claude Code（CLI）

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

测试连接

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

你应该会收到列出全部 8 个工具的 JSON。

---

工具

工具	用途
list_songs	列出所有歌曲（按篇章 slug 或发行状态筛选）
get_song	按 ID 或 slug 获取一首歌曲 — 歌词、引言、封面图片、流媒体链接、所属篇章
list_chapters	列出所有篇章及其罗马数字、名称、年份范围、情绪标签和歌曲数量
get_chapter	获取一个篇章及其所有歌曲和完整 ACF 叙事
get_artist	艺人资料及传记背景
get_experience	针对某种聆听模式，一次性获取策划好的播放列表 — 歌曲、场景、新生成的流媒体 URL
get_experience_prompt	返回 AI Agent 用于主持聆听会话的叙述提示词模板
refresh_stream_urls	批量生成新的音频签名 URL，避免现有 URL 过期

所有工具均返回 JSON-RPC 2.0 响应。支持流媒体播放的歌曲会根据 release_status 控制是否允许播放；篇章叙事则根据 chapter_released 控制是否开放。

---

可尝试的示例提示词

安装后，向 Claude 提问：

“列出 Matthew Hartley 的歌曲，并告诉我 ‘Heaven's Calling’ 背后的故事。”

“使用 get_experience 工具为我打造一段 quiet_listening 体验。然后像讲故事一样，为我介绍每首歌。”

“他的专辑按篇章展开了怎样的旅程？”

“为我播放 Chapter VI，并解释在那个时期他的生活发生了什么变化。”

get_experience 工具最具价值 — 一次请求即可返回按顺序编排的完整播放列表，其中包含流媒体 URL 和视觉场景提示，可直接用于聆听会话。

---

参考播放器

我们直接基于此 MCP 构建了一款专用浏览器播放器：

Harmonic Wave 体验媒体播放器 — 一种电影感十足、可随音频动态变化的聆听体验，包含 DJ 配音、与 LRC 同步的歌词叠层以及每首歌专属的视觉色调。无需安装 — 打开即可聆听。

---

架构

┌─────────────────────────────┐
│  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 承载目录（自定义文章类型 song 和 artist、分类法 chapter，以及用于存储歌词／故事／流媒体链接的 ACF 字段）
• 音频文件存放在私有 Cloudflare R2 存储桶中，通过按需生成的 AWS Sig V4 预签名 URL 访问
• MCP 端点完全公开，无需身份验证。每首歌曲的流媒体播放由服务端根据发行状态进行限制。

---

关于 Matthew Hartley

Matthew Hartley 是一位来自佛罗里达州萨拉索塔的基督教摇滚歌曲创作者，也是一位拥有 25 年以上从业经验的软件行业资深人士，职业生涯涵盖工程、架构、销售和高管领导工作，并拥有多项 USPTO 专利申请。他领导着 Imagine Peak Studios，这家工作室打造了此 MCP 和 Harmonic Wave 平台。《The Time Is Now: A Journey in Chapters》是一张包含十二首歌曲的专辑，创作历时二十五年（1999–2026），由六个篇章组成，追溯纯真与心碎、觉醒、打破循环、爱与承诺、崩塌与召唤，以及脚踏实地的信仰。

• 网站： matthewhartleymusic.com
• 体验式播放器： experience.matthewhartleymusic.com
• Spotify、Apple Music、YouTube、SoundCloud： 均在 MCP 响应中提供各首歌曲的链接

---

由 Harmonic Wave 提供支持

此服务基于 Harmonic Wave 平台构建，旨在帮助内容创作者打造适用于 AI 的作品。

该平台还包含一个 适用于 Claude Code 的 Harmonic Wave 插件，可将提示词转化为平台目录的自定义媒体播放器。

---

许可证

本仓库中的文档依据 Apache License 2.0 授权。MCP 服务的 WordPress mu-plugin 源代码为专有内容，未包含在本仓库中。MCP 所提供的音乐、歌词、故事内容和音频录音均为 © Imagine Peak Studios 所有，保留所有权利。