Roku MCP (Jack1590)

年份-MCP

A. 模型上下文协议 用于Roku设备自动化的（MCP）服务器。公开用于应用程序部署、ECP远程控制、屏幕截图捕获、SceneGraph节点检查和BrightScript调试控制台访问的工具。

安装

npm install -g roku-mcp

或者直接使用npx运行（无需安装）：

npx roku-mcp

客户端配置

光标

1. 创建 .cursor/mcp.json 在项目根目录中：

{
  "mcpServers": {
    "roku": {
      "command": "npx",
      "args": ["-y", "roku-mcp"],
      "env": {
        "ROKU_DEVICE_HOST": "192.168.1.XXX",
        "ROKU_DEVICE_PASSWORD": "your-password"
      }
    }
  }
}

1. 重新加载窗口： Cmd+Shift+P （macOS）/ Ctrl+Shift+P （Windows/Linux）→ 开发者：重新加载窗口
2. 首选 光标设置→ MCP 并验证“roku”服务器是否显示绿色状态。如果它显示为禁用，请单击切换以启用它。

VS Code

需要VS代码 1.99+ 使用GitHub Copilot扩展。

1. 创建 .vscode/mcp.json 在项目根目录中：

{
  "servers": {
    "roku": {
      "command": "npx",
      "args": ["-y", "roku-mcp"],
      "env": {
        "ROKU_DEVICE_HOST": "192.168.1.XXX",
        "ROKU_DEVICE_PASSWORD": "your-password"
      }
    }
  }
}

1. 重新加载窗口： Cmd+Shift+P / Ctrl+Shift+P → 开发者：重新加载窗口
2. 打开Copilot聊天并切换到 代理模式 （从聊天模式下拉列表中选择）。roku工具将在那里提供。

克劳德桌面版

添加到您的Claude Desktop配置文件中：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "roku": {
      "command": "npx",
      "args": ["-y", "roku-mcp"],
      "env": {
        "ROKU_DEVICE_HOST": "192.168.1.XXX",
        "ROKU_DEVICE_PASSWORD": "your-password"
      }
    }
  }
}

保存后重新启动Claude Desktop。

帆板运动

创建 .windsurf/mcp.json 在项目根目录中：

{
  "mcpServers": {
    "roku": {
      "command": "npx",
      "args": ["-y", "roku-mcp"],
      "env": {
        "ROKU_DEVICE_HOST": "192.168.1.XXX",
        "ROKU_DEVICE_PASSWORD": "your-password"
      }
    }
  }
}

保存后重新加载窗口。

任何兼容MCP的客户端

服务器使用 stdio传输任何支持MCP的客户端都可以通过以下方式启动它：

command: npx
args:    ["-y", "roku-mcp"]

通过 ROKU_DEVICE_HOST 和 ROKU_DEVICE_PASSWORD 或者省略主机以使用SSDP自动发现。

环境变量

两者也可以在每次工具调用时作为参数传递，从而覆盖环境变量。

自动发现

如果 ROKU_DEVICE_HOST 未设置且否 host 如果提供了参数，服务器将使用SSDP自动发现本地网络上的Roku设备，并使用第一个发现的设备。您还可以使用 roku_discover 工具列出所有可用设备。请注意，无法发现密码，仍必须配置密码。

.env 文件支持

服务器自动加载 .env 使用以下命令从当前工作目录中删除文件 Dotenv。如果你的项目 .env 已使用 ROKU_DEVICE_HOST 和 ROKU_DEVICE_PASSWORD，服务器无需额外配置即可获取它们——只需省略 env 从MCP配置中屏蔽：

ROKU_DEVICE_HOST=192.168.1.100
ROKU_DEVICE_PASSWORD=my-password

如果您的项目使用不同的变量名（例如。 ROKU_IP, ROKU_DEV_PASSWORD)，您可以在 env 块：

"env": {
  "ROKU_DEVICE_HOST": "${ROKU_IP}",
  "ROKU_DEVICE_PASSWORD": "${ROKU_DEV_PASSWORD}"
}

或者简单地将两个预期变量添加到您的 .env 除了你现有的。

可用工具

部署

发现

ECP（外部控制协议）

截图

调试控制台

BrightScript分析器

分析 .bsprof Roku设备生成的文件。这些工具使用 bsprof-cli 解析二进制分析器格式并返回结构化JSON报告。

生成一个 .bsprof 文件，在Roku应用程序中启用分析器 manifest (bs_prof_enabled=true)，运行应用程序，然后从下载配置文件 http://:8080.

完美追踪

记录、分析和比较Roku设备的Perfetto痕迹。需要 年OS 15.1+。这些工具使用 年度完美 用于ECP控制、WebSocket记录和PerfettoSQL分析。

工作流：启用跟踪→ 开始录制→ 与应用程序交互→ 停止录制→ 分析。这 .trace 文件也可以在以下位置打开 ui.完美.dev.

需求

• Node.js 18+
• Roku设备 开发者模式 在同一网络上启用
• 对于屏幕截图和部署：必须运行一个侧向加载的开发通道

许可证

麻省理工学院