AI导哈

PS5远程控制协议

一个用于发现、注册和远程唤醒本地网络中PS5游戏主机的模型上下文协议服务器。

  • by pkyanam
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 pkyanam/claude-ps5-mcp

使用说明

claude-ps5-mcp

npm版本

一个模型上下文协议（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唤醒工作：

  1. 启用“保持与互联网的连接”

    • 设置→ 系统→ 节能→ 休息模式下可用的功能

  2. 使用休息模式 （未完全断电）

    • 短按电源按钮，直到它闪烁蓝色
    • 或使用快速菜单→ 力量→ 进入休息模式

  3. 同一网络

    • 您的计算机和PS5必须位于同一本地网络上

故障排除

未找到控制台

  • 确保PS5处于休息模式（未完全关闭）
  • 验证是否启用了“保持连接到互联网”
  • 检查两台设备是否在同一网络上
  • 尝试在您的计算机上禁用VPN

注册失败

  • PS5必须打开（不处于待机状态）
  • PIN在几分钟后过期-刷新它
  • 确保你在设置中→ 系统→ 远程播放→ 链接设备

唤醒包已发送，但控制台未打开

  • 等待10-30秒，让控制台唤醒
  • 验证PS5是否处于休息模式（橙灯）
  • 请确保您已先完成注册

找不到设备的凭据

  • 首先运行PSN身份验证
  • 使用您的PIN完成设备注册
  • 检查凭据是否存在于 ~/.config/playactor/credentials.json

运作原理

服务器使用UDP广播在您的本地网络上发现PlayStation游戏机，然后使用索尼的设备发现协议（DDP）与它们通信。凭据存储在本地，用于发送经过身份验证的唤醒数据包。

许可证

麻省理工学院

相关 MCP