Matthew Hartley Music MCP Server

官方

首个艺术家自有的MCP服务器,专为AI代理使用。从任何AI客户端发现、讲述并流式播放Matthew Hartley的首张专辑《The Time Is Now: A Journey in Chapters》。由Harmonic Wave提供支持。

文档

Matthew Hartley — The Time Is Now: A Journey in Chapters · Powered by Harmonic Wave

Matthew Hartley Music — MCP 服务器

首个艺术家自有的 MCP 服务器。 在任何支持 模型上下文协议 的 AI 客户端中,发现、讲述并流式播放一张连续的、故事驱动的专辑。

在线端点(公开,无需认证):

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

这是什么

此 MCP 服务器将 《此刻即永恒:章节之旅》 —— Matthew Hartley 的首张专辑 —— 呈现为一种结构化的、AI 原生的体验。十二首歌曲跨越六个章节,每首都包含歌词、情感叙事、版本录音和直接的流媒体链接。其设计旨在让任何 AI 客户端都能:

  • 发现目录 —— 通过丰富的元数据列出歌曲和章节
  • 讲述每首歌背后的故事 —— 简短和完整的叙事、歌词、情绪标签
  • 策划一个有序的聆听体验 —— 六种聆听模式(late_nightdevotionalacoustic_focuscinematicquiet_listeningfull_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(命令行界面)

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列出所有歌曲(可按章节别名或发布状态筛选)
get_song通过 ID 或别名获取单首歌曲 —— 歌词、引言、封面图、流媒体链接、所属章节
list_chapters列出所有章节,包含编号、名称、年份范围、情绪标签、歌曲数量
get_chapter获取单个章节及其所有歌曲和完整的 ACF 叙事
get_artist艺术家简介及生平背景
get_experience为一种聆听模式生成一次性策划的播放列表 —— 歌曲、场景、新的流媒体 URL
get_experience_prompt返回 AI 代理用于主持聆听会话的旁白提示模板
refresh_stream_urls在现有 URL 过期前,批量生成新的签名音频 URL

所有工具均返回 JSON-RPC 2.0 响应。可流式播放的歌曲通过 release_status 控制流媒体访问;章节叙事通过 chapter_released 控制访问。


可尝试的示例提示

安装后,向 Claude 提问:

“列出 Matthew Hartley 的歌曲,并告诉我《Heaven's Calling》背后的故事。”

“使用 get_experience 工具为我构建一个 quiet_listening 体验。然后像讲故事的人介绍每首歌那样进行旁白。”

“他的专辑逐章讲述了怎样的旅程?”

“为我播放第六章,并解释在那个时期他的生活发生了什么变化。”

get_experience 工具是效率最高的调用 —— 一次请求即可返回一个完全排序的播放列表,包含流媒体 URL 和视觉场景提示,随时可用于聆听会话。


参考播放器

一个专用的浏览器播放器直接构建在此 MCP 之上:

谐波体验媒体播放器 —— 一种电影般的、音频反应式的聆听体验,包含 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 托管目录(自定义文章类型 songartist,分类法 chapter,用于歌词/故事/流媒体链接的 ACF 字段)
  • 音频文件存储在私有的 Cloudflare R2 存储桶中,通过按需生成的 AWS Sig V4 预签名 URL 访问
  • MCP 端点完全公开 —— 无需认证。每首歌曲的流媒体访问由服务器端根据发布状态进行控制。

关于 Matthew Hartley

Matthew Hartley 是一位来自佛罗里达州萨拉索塔的基督教摇滚歌曲作者,同时也是一位拥有超过 25 年软件行业经验的资深人士,其职业生涯涵盖工程、架构、销售和高管领导,并拥有多项 USPTO 专利申请。他领导着 Imagine Peak Studios,这是此 MCP 及谐波平台背后的工作室。《此刻即永恒:章节之旅》 是一张跨越二十五年(1999–2026)创作的十二首歌曲专辑 —— 六个章节追溯了纯真与心碎、觉醒、打破循环、爱与承诺、崩溃与召唤,以及扎根的信仰。


由谐波驱动

此服务器构建在 谐波 平台之上 —— 为内容创作者使其作品成为 AI 原生。

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


许可证

此仓库中的文档根据 Apache License 2.0 许可。MCP 服务器的 WordPress mu-plugin 源代码是专有的,不包含在此仓库中。MCP 公开的音乐、歌词、故事内容和音频录音版权归 © Imagine Peak Studios —— 保留所有权利。