Matthew Hartley Music MCP Server
官方首个艺术家自有的MCP服务器,专为AI代理使用。从任何AI客户端发现、讲述并流式播放Matthew Hartley的首张专辑《The Time Is Now: A Journey in Chapters》。由Harmonic Wave提供支持。
文档
Matthew Hartley Music — MCP 服务器
首个艺术家自有的 MCP 服务器。 在任何支持 模型上下文协议 的 AI 客户端中,发现、讲述并流式播放一张连续的、故事驱动的专辑。
在线端点(公开,无需认证):
https://matthewhartleymusic.com/wp-json/mcp/v1/message
这是什么
此 MCP 服务器将 《此刻即永恒:章节之旅》 —— Matthew Hartley 的首张专辑 —— 呈现为一种结构化的、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(命令行界面)
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 托管目录(自定义文章类型
song和artist,分类法chapter,用于歌词/故事/流媒体链接的 ACF 字段) - 音频文件存储在私有的 Cloudflare R2 存储桶中,通过按需生成的 AWS Sig V4 预签名 URL 访问
- MCP 端点完全公开 —— 无需认证。每首歌曲的流媒体访问由服务器端根据发布状态进行控制。
关于 Matthew Hartley
Matthew Hartley 是一位来自佛罗里达州萨拉索塔的基督教摇滚歌曲作者,同时也是一位拥有超过 25 年软件行业经验的资深人士,其职业生涯涵盖工程、架构、销售和高管领导,并拥有多项 USPTO 专利申请。他领导着 Imagine Peak Studios,这是此 MCP 及谐波平台背后的工作室。《此刻即永恒:章节之旅》 是一张跨越二十五年(1999–2026)创作的十二首歌曲专辑 —— 六个章节追溯了纯真与心碎、觉醒、打破循环、爱与承诺、崩溃与召唤,以及扎根的信仰。
- 网站: matthewhartleymusic.com
- 体验播放器: experience.matthewhartleymusic.com
- Spotify、Apple Music、YouTube、SoundCloud: 所有链接均在 MCP 响应中按歌曲提供
由谐波驱动
此服务器构建在 谐波 平台之上 —— 为内容创作者使其作品成为 AI 原生。
该平台还包含一个 适用于 Claude Code 的谐波插件,可将提示转化为平台上目录的自定义媒体播放器。
许可证
此仓库中的文档根据 Apache License 2.0 许可。MCP 服务器的 WordPress mu-plugin 源代码是专有的,不包含在此仓库中。MCP 公开的音乐、歌词、故事内容和音频录音版权归 © Imagine Peak Studios —— 保留所有权利。