🔥 Local Fire TV MCP Server

A Model Context Protocol (MCP) server that provides real Fire TV control through ADB commands. This server runs locally on your machine and can actually control your Fire TV device!

🎯 What This Does

• Real Fire TV Control: Execute actual ADB commands to control your Fire TV
• MCP Protocol: Proper MCP server implementation for integration with AI assistants
• Local Execution: Runs on your machine with full system access
• Comprehensive Control: Navigation, apps, volume, search, and more

🛠️ Prerequisites

1. ADB (Android Debug Bridge):

   brew install android-platform-tools  # macOS

2. Fire TV Setup:

   • Settings → My Fire TV → About → Click Fire TV name 7 times (enables Developer Options)
   • Settings → My Fire TV → Developer Options → Turn ON "ADB debugging"
   • Settings → My Fire TV → Developer Options → Turn ON "Apps from Unknown Sources"

3. Node.js: Version 18+ required

🚀 Quick Start

1. Install dependencies:

   npm install

2. Start the MCP server:

   npm start

3. Test the server (in another terminal):

   # Simple test
   echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | node src/index.js

🎮 Available Tools

firetv_control

Control Fire TV with these commands:

• Navigation: home, back, up, down, left, right, select, menu
• Power: wake, sleep
• Volume: volume_up, volume_down, mute
• Media: play_pause
• Apps: open_youtube, open_netflix, open_prime, open_disney, open_hulu
• YouTube Advanced:
  • youtube_search (with value) - Search YouTube for specific content
  • youtube_play (with value) - Search and play first result automatically
• Netflix Advanced:
  • netflix_continue - Resume watching your last show
  • netflix_search (with value) - Search Netflix for specific content
• Input: search (with value), type (with value)
• Info: get_current_app, list_apps, screenshot

firetv_status

Check Fire TV connection status and ADB availability.

firetv_connect

Connect to Fire TV via ADB (optionally specify IP address).

firetv_apps

List available Fire TV apps and their package names.

📱 Example Usage

In Claude/MCP Client:

firetv_control(command="open_netflix")
firetv_control(command="youtube_search", value="funny cat videos")
firetv_control(command="youtube_play", value="cooking tutorial")
firetv_control(command="netflix_continue")
firetv_control(command="netflix_search", value="stranger things")
firetv_control(command="volume_up")
firetv_status()

Direct MCP Calls:

# Open Netflix
echo '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "firetv_control",
    "arguments": {"command": "open_netflix"}
  }
}' | node src/index.js

# Go to home screen
echo '{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "firetv_control",
    "arguments": {"command": "home"}
  }
}' | node src/index.js

🔧 Configuration

The server is configured for Fire TV at IP 192.168.1.54. To change this, modify the fireTVIP property in src/index.js or use the firetv_connect tool with a different IP.

🎉 Real vs Simulated

This is the REAL DEAL! Unlike cloud-based solutions that can only simulate commands, this local MCP server:

• ✅ Actually executes ADB commands
• ✅ Really controls your Fire TV
• ✅ Opens apps, navigates, changes volume
• ✅ Works with any MCP-compatible client

🐛 Troubleshooting

"ADB not available"

brew install android-platform-tools
adb version  # Should show version info

"Cannot connect to Fire TV"

1. Enable Developer Options (click Fire TV name 7 times in About)
2. Turn ON "ADB debugging" in Developer Options
3. Check Fire TV is on same network
4. Try: adb connect 192.168.1.54:5555

"Authentication failed"

• You should see a permission popup on Fire TV
• Select "Always allow from this computer"
• Restart Fire TV if needed

🔌 Integration

With Claude Desktop

Add to your MCP configuration:

{
  "mcpServers": {
    "firetv": {
      "command": "node",
      "args": ["/path/to/local-firetv-mcp/src/index.js"],
      "env": {}
    }
  }
}

With Other MCP Clients

Use the stdio transport to connect to the server at src/index.js.