MCP setup and connection

Switch the server on, find the address, connect your AI client.

• Overview
• Setup
• All 42 tools
• AI operating manual
• Use cases
• Schedules
• Translation
• Security

Three steps: switch the server on, find the TV's address, connect an AI client. Replace <tv-ip> below with your own TV's address.

Step 1: switch the server on

• Install and open VxMouse.
• Enable the accessibility service (see mouse mode).
• Scroll to the MCP Server (Model Context Protocol) section and turn on Enable MCP Server.
• The first time, Android may ask for all-files access so the file tools can work. Allow it from the screen it shows.

The status line turns green with MCP Server: Running on port 8787 when it is up. If it stays on Stopped, the port is probably in use: pick another one.

Step 2: find the TV address

Use your router's device list or the TV's network settings. On the same network the address is ws://<tv-ip>:8787. From another network, use the USB-forward route in method B.

Method A: Claude Desktop with the bridge (recommended)

You need Node.js 18 or newer and the bridge files (the bridge script, its package file and its config file) in one folder. Install its single dependency once with npm install.

Edit the bridge config:

{
  "vxmouse": {
    "ip": "<tv-ip>",
    "port": 8787,
    "token": "",
    "tls": false
  },
  "connection": {
    "timeout": 3000,
    "keepaliveInterval": 30000,
    "reconnect": true,
    "reconnectDelay": 5000,
    "maxReconnectAttempts": 10
  }
}

Then add the bridge to the Claude Desktop config file, using the path where you saved it. The config file must sit next to the bridge script.

{
  "mcpServers": {
    "vxmouse": {
      "command": "node",
      "args": ["<path-to>/bridge.js"]
    }
  }
}

Restart Claude Desktop. The vx_* tools appear in its tool list. On the first message the AI is told to call get_skill.

Method B: connect through USB or a forwarded port

If the computer and TV are on different networks, forward the port over an ADB connection, then point the bridge at 127.0.0.1 instead of the TV's address, with the same port, "tls": false and your token. Good for remote support and development.

Method C: write your own client

Any language with a WebSocket library can be a client. Send initialize, then notifications/initialized, then tools/call. This Python sketch shows a toast on the TV:

import json, asyncio, websockets

async def main():
    async with websockets.connect("ws://<tv-ip>:8787") as ws:
        await ws.send(json.dumps({"jsonrpc": "2.0", "id": 1, "method": "initialize",
            "params": {"protocolVersion": "2024-11-05", "capabilities": {},
                       "clientInfo": {"name": "my-agent", "version": "1.0"}}}))
        print(await ws.recv())
        await ws.send(json.dumps({"jsonrpc": "2.0", "method": "notifications/initialized", "params": {}}))
        await ws.send(json.dumps({"jsonrpc": "2.0", "id": 2, "method": "tools/call",
            "params": {"name": "vx_display_toast", "arguments": {"message": "Hi from Python"}}}))
        print(await ws.recv())

asyncio.run(main())

With a token set, send this right after initialize: {"jsonrpc":"2.0","id":99,"method":"auth","params":{"token":"your-token"}}

It works when you see this

Troubleshooting