@mokuichi147/webos-mcp
Allows launching YouTube videos on the TV by passing a contentTarget URL to the YouTube app, and controlling playback with media controls such as play, pause, stop, rewind, and fast-forward.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@mokuichi147/webos-mcp Turn on the living room TV and launch Netflix"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@mokuichi147/webos-mcp
LG webOS TV を操作する MCP (Model Context Protocol) サーバーです。 SSAP (Second Screen Application Protocol) で TV と直接通信するため、TV 側への追加インストールは不要です。
アプリ起動・音量・リモコンキー・マウスポインタ・外部入力の操作
放送の選局、現在の番組・番組表の取得
スクリーンショットの取得(LLM が画面を見ながら操作できる)
Wake-on-LAN による電源オン
セットアップ
1. MCP クライアントに登録
Claude Desktop / Claude Code などの設定に追加します。
{
"mcpServers": {
"webos": {
"command": "npx",
"args": ["-y", "@mokuichi147/webos-mcp"]
}
}
}2. TV とペアリング
MCP クライアントから次の順で呼びます。
discover_devices— LAN 上の TV を探索pair_device— TV 画面に表示される承認ダイアログで「はい」を選ぶとclient-keyが保存される
CLI から事前にペアリングしておくこともできます。
npx -y @mokuichi147/webos-mcp discovernpx -y @mokuichi147/webos-mcp pair 192.168.1.20 --name living-room以降は launch_app などのツールをそのまま呼べます。
Related MCP server: sony-bravia-mcp
ツール
TV を操作するツールはすべて device(登録名または IP)を省略可能な引数として受け取ります。省略時は既定デバイスを使います。
デバイス管理
ツール | 説明 |
| LAN 上の webOS TV を SSDP で探索 |
| TV とペアリングして |
| 登録済みデバイスの一覧 |
| 登録を削除 |
| 既定デバイスを設定 |
アプリ
ツール | 説明 |
| インストール済みアプリの ID とタイトル |
| 前面に表示中のアプリ |
| アプリを起動。 |
| アプリを終了(ブラウザ等のシステムアプリは |
| TV のブラウザで URL を開く |
音量・音声
ツール | 説明 |
| 音量とミュート状態 |
| 音量を 1 段階上下 |
| 音量を 0〜100 で設定 |
| ミュートの ON / OFF / トグル |
| 音声出力先( |
入力操作
ツール | 説明 |
| リモコンキーを送信(複数指定で順送り)。 |
| マジックリモコンのポインタを相対移動・クリック・スクロール |
| フォーカス中のテキストフィールドへ文字入力・削除 |
|
|
| 外部入力(HDMI など)の一覧と切替 |
放送(チューナー)
ツール | 説明 |
| アプリや外部入力から放送視聴に切替 |
| チャンネル一覧。種別(地デジ / BS / CS / 4K)や局名で絞り込み |
| 視聴中のチャンネルと放送中の番組(名前・内容・時刻) |
| 視聴中チャンネルの番組表 |
| 選局。番号( |
| チャンネル送り |
電源・システム
ツール | 説明 |
| Wake-on-LAN で電源オン |
| 電源オフ(スタンバイ) |
| 電源状態 |
| 画面のスクリーンショット(960×540 JPEG)を画像として返す |
| システム設定(画質・音声など)の取得・変更 |
| 画面にトースト通知を表示 |
| モデル名などの情報 |
制限事項
項目 | 内容 |
スクリーンショット | 解像度は TV 側で 960×540 に固定。DRM 保護された動画(Netflix / Prime Video など)の再生中は黒く写る |
電源オン | SSAP では不可能なため Wake-on-LAN を使う。TV 側で「ネットワーク経由で電源オン」等の設定が必要。 |
放送情報 |
|
文字入力 | システムの仮想キーボードがテキストフィールドにフォーカスしている場合のみ動作する(ブラウザなど)。YouTube のようにアプリ独自のキーボードを持つアプリには入力できない。ブラウザでキーボードが出ない場合は |
マウス座標 | 1920×1080 相当の相対移動( |
設定変更 |
|
再生制御 |
|
設定ファイル
デバイス情報は ~/.config/webos-mcp/devices.json(XDG_CONFIG_HOME を尊重)に保存されます。
{
"version": 1,
"defaultDevice": "living-room",
"devices": {
"living-room": {
"name": "living-room",
"host": "192.168.1.20",
"id": "560ad548-....",
"model": "OLED65B6MJA",
"clientKey": "...",
"mac": "D0:CD:BF:...",
"wifiMac": "70:3E:76:..."
}
}
}CLI オプション / 環境変数
オプション | 環境変数 | 説明 |
|
| 既定デバイス名 |
|
| 設定ファイルを使わず直接接続する TV |
|
|
|
|
| 設定ディレクトリ |
|
| デバッグログを stderr に出力 |
ファームウェアとマニフェスト
webOS 26 以降のファームウェアは、従来のリモコンアプリ由来の署名付きマニフェストを
403 Pairing rejected: blacklisted certificate detected で拒否します。
本サーバーはまず署名付きで登録を試み、拒否された場合のみ署名なしマニフェストで再登録します。
署名なしでは WRITE_SETTINGS など一部の権限が付与されないため、set_settings が 401 になります。
開発
npm installnpm run buildnode dist/cli.js discoverロードマップ
SSAP による探索・ペアリング・アプリ/音量/キー操作
放送・スクリーンショット・Wake-on-LAN
TV 側 Companion アプリ(Luna API ブリッジ)
SSAP / Luna の自動切替と Luna 固有ツール(高解像度キャプチャ、設定変更など)
License
MIT
Available Tools
39 toolschannel_downチャンネルを下げるB
前のチャンネルへ切り替える。
Inputs: device.
channel_upチャンネルを上げるC
次のチャンネルへ切り替える。
Inputs: device.
close_appアプリ終了B
指定したアプリを終了する。
Inputs: appId (required), device.
delete_text文字削除A
フォーカス中のテキストフィールドからカーソル前の文字を削除する。
Inputs: count, device.
discover_devicesTV を探索ARead-only
LAN 上の LG webOS TV を SSDP で探索し、IP・名前・モデルを返す。
Inputs: timeoutMs.
get_current_app前面アプリを取得ARead-only
現在前面に表示されているアプリの ID を返す。
Inputs: device.
get_current_channel現在のチャンネルと番組ARead-only
視聴中のチャンネルと、放送中の番組名・内容・開始/終了時刻を返す。放送視聴中でない場合はその旨を返す。
Inputs: device.
get_power_state電源状態ARead-only
TV の電源状態を返す(Active / Active Standby / Screen Off など)。TV がスタンバイで応答しない場合はその旨を返す。
Inputs: device.
get_program_guide番組表ARead-only
視聴中チャンネルの番組表(これから放送される番組の一覧)を返す。放送視聴中でない場合はその旨を返す。
Inputs: device.
get_settings設定を取得ARead-only
システム設定を取得する。例: category=picture keys=[brightness,contrast,backlight,color,pictureMode] / category=sound keys=[soundMode]。
Inputs: keys (required), category (required), device.
get_sound_output音声出力先を取得ARead-only
現在の音声出力先を返す(tv_speaker, external_optical, external_arc, bt_soundbar, headphone など)。
Inputs: device.
get_system_infoシステム情報ARead-only
TV のモデル名・webOS バージョン等を返す。
Inputs: device.
get_volume音量取得ARead-only
現在の音量とミュート状態を返す。
Inputs: device.
insert_text文字入力A
TV 上でフォーカスされているテキストフィールド(検索欄など)に文字列を入力する。入力欄が表示されていないと失敗する。enter=true で入力後に確定する。
Inputs: text (required), enter, device, replace.
launch_appアプリ起動A
アプリ ID(例: netflix, youtube.leanback.v4, com.webos.app.hdmi1)でアプリを起動する。任意で起動パラメータを渡せる。
Inputs: appId (required), device, params.
list_appsアプリ一覧ARead-only
TV にインストールされているアプリの ID とタイトルを返す。launch_app にはこの id を渡す。
Inputs: device, includeHidden.
list_channelsチャンネル一覧BRead-only
受信可能なチャンネル一覧を返す。type で放送種別を絞り込める(例: Terrestrial=地デジ, BS, CS, UHD=4K)。set_channel には number / name / channelId のいずれでも渡せる。
Inputs: type, query, device, includeSkipped.
list_devices登録済みデバイス一覧ARead-only
devices.json に保存されているデバイスと既定デバイスを返す。
Inputs: no named parameters.
list_inputs外部入力一覧ARead-only
HDMI などの外部入力の ID・ラベル・接続状態を返す。switch_input にはこの id を渡す。
Inputs: device.
media_control再生制御A
再生・一時停止・停止・巻き戻し・早送りを送る。アプリによっては対応していない。
Inputs: action (required), device.
muteミュート切替A
ミュートを ON/OFF する。mute 省略時はトグル。
Inputs: mute, device.
open_urlURL をブラウザで開くA
TV のブラウザで URL を開く。
Inputs: url (required), device.
pair_deviceTV とペアリングA
指定した IP の TV に接続してペアリングする。TV 画面に表示される承認ダイアログでユーザーが「はい」を選ぶまで待機し、client-key を保存する。
Inputs: host (required), name, makeDefault.
power_off電源オフADestructive
TV の電源を切る(スタンバイ)。
Inputs: device.
power_on電源オン (Wake-on-LAN)A
Wake-on-LAN で TV の電源を入れる。pair_device 時に保存した MAC アドレスを使う(mac パラメータで上書き可)。TV 側で「ネットワーク経由で電源オン」等の設定が有効である必要がある。
Inputs: mac, device.
remove_deviceデバイス登録を削除ADestructive
保存済みのデバイス(client-key を含む)を削除する。
Inputs: name (required).
screenshotスクリーンショットARead-only
TV 画面のスクリーンショット (960x540 JPEG) を取得する。現在の表示内容を確認してから操作したいときに使う。DRM 保護された動画(Netflix / Prime Video 等の再生中)は黒く写る。
Inputs: device.
send_keyリモコンキー送信B
リモコンのボタン操作を送る。複数指定すると順に送信する。使用可能なキー: LEFT, RIGHT, UP, DOWN, ENTER, BACK, EXIT, HOME, MENU, INFO, GUIDE, DASH, VOLUMEUP, VOLUMEDOWN, MUTE, CHANNELUP, CHANNELDOWN, PLAY, PAUSE, STOP, REWIND, FASTFORWARD, RECORD, RED, GREEN, YELLOW, BLUE, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, ASTERISK, CC, POWER, CLICK
Inputs: keys (required), device.
send_mouseマウス操作A
TV のマウスポインタを操作する。move は相対移動(画面は 1920x1080 相当。screenshot の 960x540 座標の 2 倍)。絶対位置に置きたいときは先に大きな負の値で左上に寄せてから移動する(例: move -3000,-3000 → move 960,512)。ブラウザ等でテキスト欄をクリックして仮想キーボードを出すときに使う。
Inputs: action (required), dx, dy, device.
set_channel選局B
チャンネルを切り替える。channel には番号(例: 011, 41)、局名(例: NHK総合, テレ東)、channelId のいずれかを指定。放送視聴中でなければ自動で切り替える。
Inputs: channel (required), device.
set_default_device既定デバイスを設定A
device パラメータ省略時に使うデバイスを設定する。
Inputs: name (required).
set_settings設定を変更B
システム設定を変更する。例: category=picture settings={backlight: 60}。TV のファームウェアによっては WRITE_SETTINGS 権限がなく 401 になる。
Inputs: category (required), settings (required), device.
set_sound_output音声出力先を変更C
音声出力先を切り替える。
Inputs: output (required), device.
set_volume音量を設定B
音量を 0〜100 で設定する。
Inputs: volume (required), device.
show_toastトースト通知B
TV 画面にトースト通知を表示する。
Inputs: message (required), device.
switch_input外部入力を切替C
外部入力を切り替える(例: HDMI_1, HDMI_2)。
Inputs: inputId (required), device.
volume_down音量を下げるA
音量を 1 段階下げる。
Inputs: device.
volume_up音量を上げるB
音量を 1 段階上げる。
Inputs: device.
watch_tv放送視聴に切替A
アプリや外部入力からテレビ放送(チューナー)の視聴に切り替える。
Inputs: device.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 39 tools
Most tools cleanly separate domains like device management, apps, volume, inputs, and channels. However, send_key overlaps with media_control, volume controls, power_off, and channel_up/down, which creates ambiguity about whether to use the generic key sender or the specialized wrappers.
The vast majority of tools follow a clear snake_case verb_noun pattern: list_apps, get_volume, set_channel, launch_app. A few exceptions like mute, screenshot, volume_up, channel_down, and power_on break the pattern slightly, but the overall convention is consistent and readable.
39 tools is well beyond the typical well-scoped range and creates significant selection burden for an agent. The count is partially justified by the breadth of TV control, but many tools duplicate what send_key already does, making the surface feel heavier than necessary.
The surface is remarkably complete for an LG webOS TV remote: discovery, pairing, device management, power, apps, inputs, audio, channels, program guide, settings, text input, mouse control, screenshots, and toasts are all covered. Agents can execute the full lifecycle from pairing to everyday control without obvious dead ends.
Related MCP Connectors
Drive WhatsApp from any MCP client: pair devices, send text and media, manage contacts and groups.
Control Android TV from any AI. 38 MCP tools: playback, recap, recommend, smart-home, schedules.
Remote MCP server for Web3TV creators — manage your account over MCP.
Unlock a world of television with the TV Maze MCP server. Effortlessly search for shows by name or
Related MCP Servers
- AlicenseCqualityCmaintenanceAn MCP server for controlling LG webOS TVs via SSAP protocol, enabling AI clients to adjust settings, switch inputs, launch apps, and more.3755 npm3MIT
- FlicenseAqualityCmaintenanceEnables MCP clients to control Sony Bravia TVs over the local network, including power, HDMI inputs, apps, volume, and mute through the TV's JSON-RPC API.8-
- AlicenseAqualityBmaintenanceLets MCP clients and the command line control LG webOS TVs directly over the local network, discovering and pairing TVs and then launching apps, switching inputs, playing YouTube videos, adjusting volume, pressing remote keys, showing messages, and powering the TV on or off.182MIT
- AlicenseBqualityBmaintenanceEnables agents and operators to control LG webOS TVs over a LAN through MCP, including apps, remote keys, pointer, text, power, discovery, route learning, and visual fallback.171MIT