内容
<p align="center">
<img src="https://experience.matthewhartleymusic.com/the-time-is-now-ai-music-experience-matthew-hartley.jpg" alt="马修·哈特利 — 现在是时候：一本分章节的故事 · 由Harmonic Wave提供支持" width="100%" />
</p>
# 马修·哈特利音乐 — MCP 服务器
> **首个艺术家拥有的MCP服务器。** 在任何支持 <a href="https://modelcontextprotocol.io" target="_blank" rel="noopener noreferrer">模型上下文协议</a> 的AI客户端中，探索、讲述和流式传输一个连续的、以故事为驱动的专辑。
**实时端点** （公开，无需认证）：
```
https://matthewhartleymusic.com/wp-json/mcp/v1/message
```
---
## 它是什么
该MCP服务器将马修·哈特利的首张专辑 **《现在是时候：一本分章节的故事》** 以结构化的、原生AI体验的方式呈现。十二首歌曲分为六个章节，每个章节包含歌词、情感叙述、版本录音和直接流媒体链接。设计使得任何AI客户端都可以：
- **发现目录** — 列出歌曲和章节，附带丰富的元数据
- **讲述每首歌背后的故事** — 简短和完整的叙述、歌词、情绪标签
- **策划顺序播放体验** — 六种播放模式（`晚间`, `祈祷`, `原声聚焦`, `电影`, `安静聆听`, `完整旅程`）和视觉呈现的场景指令
- **直接流式传输音频** — 按需生成的新的签名Cloudflare R2 URL，TTL约为4小时，并带有刷新工具以保持播放不中断
---
## 快速安装
### 克劳德桌面版
将以下内容添加到 `~/Library/Application Support/Claude/claude_desktop_config.json` （macOS）或 `%APPDATA%\Claude\claude_desktop_config.json` （Windows）：
```json
{
"mcpServers": {
"matthew-hartley-music": {
"type": "http",
"url": "https://matthewhartleymusic.com/wp-json/mcp/v1/message"
}
}
}
```
重启克劳德桌面版。该服务器将出现在您的工具列表中。
### 克劳德代码（CLI）
```bash
claude mcp add matthew-hartley-music https://matthewhartleymusic.com/wp-json/mcp/v1/message
```
### 测试连接
```bash
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代理用于托管聆听会话的叙述提示模板 |
| `refresh_stream_urls` | 批量生成新的签名音频URL，在现有URL过期之前 |
所有工具都返回JSON-RPC 2.0响应。支持流媒体的歌曲通过`release_status`控制流媒体；章节叙述通过`chapter_released`控制。
---
## 示例提示
安装完成后，询问克劳德：
> *"列出马修·哈特利的歌曲，并告诉我 'Heaven's Calling' 背后的故事。"*
> *"使用 `get_experience` 工具为我创建一个 `quiet_listening` 体验。然后像讲故事的人一样讲述它，介绍每首歌。"*
> *"他的专辑按章节讲述了什么样的故事？"*
> *"播放第六章节，并解释他在那个季节的生活发生了什么变化。"*
`get_experience` 工具是最高效的调用方式 — 一个请求返回一个完全排序的播放列表，包含流媒体URL和视觉场景提示，准备好进行聆听会话。
---
## 参考播放器
一个专用的浏览器播放器直接在这个MCP上构建：
**<a href="https://experience.matthewhartleymusic.com" target="_blank" rel="noopener noreferrer">Harmonic Wave体验媒体播放器</a>** — 一个电影化的、音频反应的聆听体验，带有DJ语音播报、LRC同步歌词叠加层和每首歌的视觉调色板。无需安装 — 直接打开并聆听。
---
## 架构
```
┌─────────────────────────────┐
│ 任何AI客户端（克劳德、 │
│ ChatGPT、Cursor等） │
└────────────┬────────────────┘
│ JSON-RPC over HTTP
▼
┌─────────────────────────────┐
│ matthewhartleymusic.com │
│ /wp-json/mcp/v1/message │
│ （WordPress mu-plugin） │
└────────────┬────────────────┘
│ 请求时签名URL
▼
┌─────────────────────────────┐
│ Cloudflare R2 │
│ （私有存储桶 — 签名 │
│ URL，仅4小时TTL） │
└─────────────────────────────┘
```
- WordPress托管目录（自定义帖子类型 `song` 和 `artist`，分类 `chapter`，ACF字段用于歌词/故事/流媒体链接）
- 音频文件存放在私有Cloudflare R2存储桶中，通过按需生成的AWS Sig V4签名URL访问
- MCP端点完全公开 — 无需认证。按歌曲的发布状态控制流媒体。
---
## 关于马修·哈特利
马修·哈特利是一位来自佛罗里达州萨拉索塔的基督教摇滚歌曲作者 — 以及一名拥有25年以上软件行业经验的资深人士，他的职业生涯涵盖工程、架构、销售和执行领导，并拥有多个USPTO专利申请。他领导 <a href="https://imaginepeakstudios.com/" target="_blank" rel="noopener noreferrer">Imagine Peak Studios</a>，这是该MCP和Harmonic Wave平台背后的工作室。 *《现在是时候：一本分章节的故事》* 是一张十二首歌曲的专辑，历时二十五年（1999-2026）创作完成 — 六个章节追溯了纯真和心碎、觉醒、打破循环、爱情和承诺、崩溃和召唤，以及坚定的信仰。
- **网站：** <a href="https://matthewhartleymusic.com" target="_blank" rel="noopener noreferrer">matthewhartleymusic.com</a>
- **体验播放器：** <a href="https://experience.matthewhartleymusic.com" target="_blank" rel="noopener noreferrer">experience.matthewhartleymusic.com</a>
- **Spotify、Apple Music、YouTube、SoundCloud：** 所有歌曲链接均包含在MCP响应中
---
## 由Harmonic Wave提供支持
该服务器构建在 <a href="https://harmonicwave.ai" target="_blank" rel="noopener noreferrer">Harmonic Wave</a> 平台上 — 面向内容创作者，使其作品具备AI原生能力。
该平台还包括一个 **<a href="https://github.com/imaginepeakstudios/harmonic-wave-plugin" target="_blank" rel="noopener noreferrer">Harmonic Wave插件，用于克劳德代码</a>** ，可将提示转换为自定义媒体播放器，用于平台上的目录。
---
## 许可证
本存储库中的文档根据 [Apache License 2.0](LICENSE) 许可。MCP服务器的WordPress mu-plugin源代码是专有的，不包含在此存储库中。通过MCP公开的音乐、歌词、故事内容和音频录音均为Imagine Peak Studios所有 — 保留所有权利。
