loading…
Search for a command to run...
loading…
Enables AI agents to develop, test, and certify Roku applications by providing direct control over device functions like app deployment, remote input, and Scene
Enables AI agents to develop, test, and certify Roku applications by providing direct control over device functions like app deployment, remote input, and SceneGraph inspection. It supports automated workflows including real-time log collection, media monitoring, and certification verification.
Roku 기기 개발, 테스트, 인증을 위한 MCP (Model Context Protocol) 서버입니다.
AI 에이전트(Gemini, Claude, Copilot 등)가 Roku 기기를 직접 제어하고 테스트할 수 있게 합니다.
| 카테고리 | 도구 | 설명 |
|---|---|---|
| 배포 | roku_deploy |
앱 사이드로드 배포 |
roku_screenshot |
화면 캡처 (base64 이미지) | |
| 디스플레이 | roku_device_info |
기기 정보 (모델, 해상도, 펌웨어) |
roku_check_resolution |
HD/FHD 해상도 호환성 검증 | |
| 입력 | roku_keypress |
리모컨 키 입력 |
roku_keypress_sequence |
키 시퀀스 전송 | |
roku_input |
커스텀 이벤트/딥링크 파라미터 | |
| 앱 관리 | roku_apps |
설치된 앱 목록 |
roku_active_app |
현재 실행 중인 앱 | |
roku_launch |
앱 실행/재시작 | |
roku_deep_link |
딥링크 인증 테스트 | |
roku_registry |
앱 레지스트리 데이터 조회 | |
roku_app_state |
앱 라이프사이클 추적 | |
| 로그 | roku_log |
BrightScript 콘솔 로그 |
| SceneGraph | roku_sg_nodes |
SG 노드 트리 검사 |
roku_perf |
CPU/메모리 사용량 | |
roku_graphics_fps |
그래픽 FPS | |
roku_element |
UI 요소 검색 (WebDriver) | |
roku_focused_element |
포커스 요소 조회 | |
| 스트리밍 | roku_media_player |
미디어 재생 상태 |
roku_server_check |
서버 헬스체크 | |
| 인증 | roku_check_drm |
DRM 콘텐츠 보호 상태 |
roku_check_accessibility |
접근성 준수 검사 | |
roku_check_raf |
RAF 광고 프레임워크 검증 | |
| 테스트 | roku_run_test |
통합 테스트 실행 |
git clone https://github.com/maskelog/roku-mcp.git
cd roku-mcp
npm install
npm run build
.env.example을 .env로 복사한 후 설정:
ROKU_DEV_HOST=192.168.0.100 # Roku 기기 IP (설정 > 네트워크 > 정보)
ROKU_DEV_PASSWORD=your_password # Developer Mode 비밀번호
ROKU_PROJECT_ROOT= # 프로젝트 루트 (기본: 상위 디렉토리)
ROKU_APP_SERVER_URL= # 앱 서버 URL (선택)
⚠️ Roku Developer Mode를 활성화해야 합니다.
AI 에이전트의 MCP 설정에 추가:
{
"mcpServers": {
"roku-dev": {
"command": "node",
"args": ["/path/to/roku-mcp/dist/index.js"],
"env": {
"ROKU_DEV_HOST": "192.168.0.100",
"ROKU_DEV_PASSWORD": "your_password"
}
}
}
}
AI 에이전트에게 자연어로 요청:
roku_device_inforoku_deploy → roku_screenshotroku_check_rafroku_check_resolutionroku_run_testMCP (Model Context Protocol) server for Roku device development, testing, and certification.
Enables AI agents (Gemini, Claude, Copilot, etc.) to directly control and test Roku devices.
| Category | Tool | Description |
|---|---|---|
| Deploy | roku_deploy |
Sideload app to device |
roku_screenshot |
Capture screen (base64 image) | |
| Display | roku_device_info |
Device info (model, resolution, firmware) |
roku_check_resolution |
Verify HD/FHD resolution support | |
| Input | roku_keypress |
Send remote key press |
roku_keypress_sequence |
Send key sequence | |
roku_input |
Custom events / deep link params | |
| App | roku_apps |
List installed apps |
roku_active_app |
Currently running app | |
roku_launch |
Launch / restart app | |
roku_deep_link |
Test deep linking (certification req.) | |
roku_registry |
Read app registry data | |
roku_app_state |
Track app lifecycle | |
| Logging | roku_log |
BrightScript console logs |
| SceneGraph | roku_sg_nodes |
Inspect SG node tree |
roku_perf |
CPU / memory usage | |
roku_graphics_fps |
Graphics frame rate | |
roku_element |
Find UI element (WebDriver) | |
roku_focused_element |
Get focused element | |
| Streaming | roku_media_player |
Media playback state |
roku_server_check |
Server health check | |
| Certification | roku_check_drm |
DRM content protection status |
roku_check_accessibility |
Accessibility compliance | |
roku_check_raf |
RAF ad framework verification | |
| Testing | roku_run_test |
Run integration test sequence |
git clone https://github.com/maskelog/roku-mcp.git
cd roku-mcp
npm install
npm run build
Copy .env.example to .env and configure:
ROKU_DEV_HOST=192.168.0.100 # Roku device IP (Settings > Network > About)
ROKU_DEV_PASSWORD=your_password # Developer Mode password
ROKU_PROJECT_ROOT= # Project root (default: parent directory)
ROKU_APP_SERVER_URL= # App server URL (optional)
⚠️ Roku Developer Mode must be enabled on the target device.
Add to your AI agent's MCP configuration:
{
"mcpServers": {
"roku-dev": {
"command": "node",
"args": ["/path/to/roku-mcp/dist/index.js"],
"env": {
"ROKU_DEV_HOST": "192.168.0.100",
"ROKU_DEV_PASSWORD": "your_password"
}
}
}
}
Ask your AI agent in natural language:
roku_device_inforoku_deploy → roku_screenshotroku_check_rafroku_check_resolutionroku_run_testroku-mcp/
├── src/
│ ├── index.ts # MCP server entry (25 tools + 2 resources)
│ ├── roku-client.ts # ECP + Dev Web Server client
│ ├── log-client.ts # BrightScript console (Telnet :8085)
│ ├── webdriver-client.ts # Roku WebDriver (port 9000)
│ └── test-runner.ts # Integration test orchestrator
├── dist/ # Compiled output
├── package.json
├── tsconfig.json
└── .env.example
| API | Port | Purpose |
|---|---|---|
| ECP (External Control Protocol) | 8060 | Device control, queries, key presses |
| Developer Web Server | 80 | App sideloading, screenshots |
| BrightScript Console | 8085 | Runtime logs, debugging |
| SceneGraph Debug | 8080 | SG-specific debugging |
| WebDriver | 9000 | UI element automation |
Every tool includes inline Roku API documentation in its description — API endpoints, ports, parameters, expected responses, and links to official docs. AI agents can use the tools without consulting external documentation.
MIT
Добавь это в claude_desktop_config.json и перезапусти Claude Desktop.
{
"mcpServers": {
"roku-mcp-server": {
"command": "npx",
"args": []
}
}
}