claude-ps5-mcp
一个模型上下文协议(MCP)服务器,使Claude Code能够发现、注册和唤醒本地网络上的PS5控制台。
特性
- PSN身份验证:登录PlayStation Network以获取基于帐户的功能
- 控制台发现:在本地网络上查找PS5/PS4主机
- 设备注册:使用PS5的远程播放PIN进行一次性注册
- 唤醒控制:从待机模式远程打开PS5
- 状态检查:检查您的主机是处于唤醒状态还是待机状态
安装
将MCP服务器添加到Claude代码中:
claude mcp add ps5 -- npx -y claude-ps5-mcp然后重新启动Claude Code以加载服务器。
快速开始
1.通过PlayStation Network进行身份验证
首先,登录您的PSN帐户:
Please start PSN authentication这将打开一个浏览器窗口。登录后,复制重定向URL并将其提供给Claude:
Complete PSN authentication with redirect URL: https://remoteplay.dl.playstation.net/remoteplay/redirect?code=...2.注册你的PS5
注册您的PS5一次(必须打开):
Register my PS5 with PIN 12345678要获取PIN码:
- 首选 设置→ 系统→ 远程播放→ 链接设备 在你的PS5上
- 注意显示的PIN码(每隔几分钟更改一次)
3.发现并唤醒您的主机
Find my PS5一旦发现,将其从待机状态唤醒:
Wake up my PS5可用工具
| 工具 | 说明 |
|---|---|
psn_login | 通过PlayStation网络进行身份验证 |
psn_get_user_info | 获取当前经过身份验证的用户信息 |
ps5_discover | 在您的网络上发现PS5/PS4主机 |
ps5_register | 注册您的PS5进行远程播放(一次性) |
ps5_wake | 发送唤醒包以打开PS5 |
ps5_status | 获取已发现控制台的状态 |
PS5要求
要使LAN唤醒工作:
- 启用“保持与互联网的连接”
- 设置→ 系统→ 节能→ 休息模式下可用的功能
- 使用休息模式 (未完全断电)
- 短按电源按钮,直到它闪烁蓝色 - 或使用快速菜单→ 力量→ 进入休息模式
- 同一网络
- 您的计算机和PS5必须位于同一本地网络上
故障排除
未找到控制台
- 确保PS5处于休息模式(未完全关闭)
- 验证是否启用了“保持连接到互联网”
- 检查两台设备是否在同一网络上
- 尝试在您的计算机上禁用VPN
注册失败
- PS5必须打开(不处于待机状态)
- PIN在几分钟后过期-刷新它
- 确保你在设置中→ 系统→ 远程播放→ 链接设备
唤醒包已发送,但控制台未打开
- 等待10-30秒,让控制台唤醒
- 验证PS5是否处于休息模式(橙灯)
- 请确保您已先完成注册
找不到设备的凭据
- 首先运行PSN身份验证
- 使用您的PIN完成设备注册
- 检查凭据是否存在于
~/.config/playactor/credentials.json
运作原理
服务器使用UDP广播在您的本地网络上发现PlayStation游戏机,然后使用索尼的设备发现协议(DDP)与它们通信。凭据存储在本地,用于发送经过身份验证的唤醒数据包。
许可证
麻省理工学院
