droidsight MCP Server

Name: droidsight MCP Server
Author: io.github.edgecasehuman

io.github.edgecasehuman/droidsight

Repository Registry

What is the droidsight MCP server?

Drives a real Android device over ADB and attaches the resulting screen to every action.

How to install droidsight

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

DROIDSIGHT_DEVICE_SERIAL
The only Android target the process may use. Required when ADB reports more than one authorized device; the server refuses to guess.
DROIDSIGHT_ADB_PATH
Explicit path to the ADB executable. Falls back to ANDROID_SDK_ROOT, ANDROID_HOME, then PATH.
DROIDSIGHT_LOCAL_ROOT
Confines host paths used by APK installation and file push/pull. Defaults to the process working directory.
DROIDSIGHT_DEVICE_PIN
secret
Numeric PIN for UI actions that require automatic unlock.
DROIDSIGHT_ALLOW_SHELL
Set to 1 to publish the arbitrary shell and macro tools. Grants authority equivalent to broad ADB shell access.
DROIDSIGHT_DEBUG_LOG
Path to a persistent debug log. File logging is otherwise disabled.
DROIDSIGHT_LOG
Tracing filter. Defaults to warn, or debug when a debug log path is set.
DROIDSIGHT_EVENTS
Set to 1 to start the long-running device event monitor. Requires DROIDSIGHT_DEVICE_SERIAL.
DROIDSIGHT_SENTINEL
Set to 1 to start the background enforcement loop. It re-applies watched device state on a timer, including unlocking the screen. Off by default.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "droidsight": {
      "command": "npx",
      "args": [
        "-y",
        "@edgecasehuman/droidsight"
      ],
      "env": {
        "DROIDSIGHT_DEVICE_SERIAL": "<YOUR_DROIDSIGHT_DEVICE_SERIAL>",
        "DROIDSIGHT_ADB_PATH": "<YOUR_DROIDSIGHT_ADB_PATH>",
        "DROIDSIGHT_LOCAL_ROOT": "<YOUR_DROIDSIGHT_LOCAL_ROOT>",
        "DROIDSIGHT_DEVICE_PIN": "<YOUR_DROIDSIGHT_DEVICE_PIN>",
        "DROIDSIGHT_ALLOW_SHELL": "<YOUR_DROIDSIGHT_ALLOW_SHELL>",
        "DROIDSIGHT_DEBUG_LOG": "<YOUR_DROIDSIGHT_DEBUG_LOG>",
        "DROIDSIGHT_LOG": "<YOUR_DROIDSIGHT_LOG>",
        "DROIDSIGHT_EVENTS": "<YOUR_DROIDSIGHT_EVENTS>",
        "DROIDSIGHT_SENTINEL": "<YOUR_DROIDSIGHT_SENTINEL>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "droidsight": {
      "command": "npx",
      "args": [
        "-y",
        "@edgecasehuman/droidsight"
      ],
      "env": {
        "DROIDSIGHT_DEVICE_SERIAL": "<YOUR_DROIDSIGHT_DEVICE_SERIAL>",
        "DROIDSIGHT_ADB_PATH": "<YOUR_DROIDSIGHT_ADB_PATH>",
        "DROIDSIGHT_LOCAL_ROOT": "<YOUR_DROIDSIGHT_LOCAL_ROOT>",
        "DROIDSIGHT_DEVICE_PIN": "<YOUR_DROIDSIGHT_DEVICE_PIN>",
        "DROIDSIGHT_ALLOW_SHELL": "<YOUR_DROIDSIGHT_ALLOW_SHELL>",
        "DROIDSIGHT_DEBUG_LOG": "<YOUR_DROIDSIGHT_DEBUG_LOG>",
        "DROIDSIGHT_LOG": "<YOUR_DROIDSIGHT_LOG>",
        "DROIDSIGHT_EVENTS": "<YOUR_DROIDSIGHT_EVENTS>",
        "DROIDSIGHT_SENTINEL": "<YOUR_DROIDSIGHT_SENTINEL>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "droidsight": {
      "command": "npx",
      "args": [
        "-y",
        "@edgecasehuman/droidsight"
      ],
      "env": {
        "DROIDSIGHT_DEVICE_SERIAL": "<YOUR_DROIDSIGHT_DEVICE_SERIAL>",
        "DROIDSIGHT_ADB_PATH": "<YOUR_DROIDSIGHT_ADB_PATH>",
        "DROIDSIGHT_LOCAL_ROOT": "<YOUR_DROIDSIGHT_LOCAL_ROOT>",
        "DROIDSIGHT_DEVICE_PIN": "<YOUR_DROIDSIGHT_DEVICE_PIN>",
        "DROIDSIGHT_ALLOW_SHELL": "<YOUR_DROIDSIGHT_ALLOW_SHELL>",
        "DROIDSIGHT_DEBUG_LOG": "<YOUR_DROIDSIGHT_DEBUG_LOG>",
        "DROIDSIGHT_LOG": "<YOUR_DROIDSIGHT_LOG>",
        "DROIDSIGHT_EVENTS": "<YOUR_DROIDSIGHT_EVENTS>",
        "DROIDSIGHT_SENTINEL": "<YOUR_DROIDSIGHT_SENTINEL>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "droidsight": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@edgecasehuman/droidsight"
      ],
      "env": {
        "DROIDSIGHT_DEVICE_SERIAL": "<YOUR_DROIDSIGHT_DEVICE_SERIAL>",
        "DROIDSIGHT_ADB_PATH": "<YOUR_DROIDSIGHT_ADB_PATH>",
        "DROIDSIGHT_LOCAL_ROOT": "<YOUR_DROIDSIGHT_LOCAL_ROOT>",
        "DROIDSIGHT_DEVICE_PIN": "<YOUR_DROIDSIGHT_DEVICE_PIN>",
        "DROIDSIGHT_ALLOW_SHELL": "<YOUR_DROIDSIGHT_ALLOW_SHELL>",
        "DROIDSIGHT_DEBUG_LOG": "<YOUR_DROIDSIGHT_DEBUG_LOG>",
        "DROIDSIGHT_LOG": "<YOUR_DROIDSIGHT_LOG>",
        "DROIDSIGHT_EVENTS": "<YOUR_DROIDSIGHT_EVENTS>",
        "DROIDSIGHT_SENTINEL": "<YOUR_DROIDSIGHT_SENTINEL>"
      }
    }
  }
}

Claude Code

claude mcp add droidsight --env DROIDSIGHT_DEVICE_SERIAL=<YOUR_DROIDSIGHT_DEVICE_SERIAL> --env DROIDSIGHT_ADB_PATH=<YOUR_DROIDSIGHT_ADB_PATH> --env DROIDSIGHT_LOCAL_ROOT=<YOUR_DROIDSIGHT_LOCAL_ROOT> --env DROIDSIGHT_DEVICE_PIN=<YOUR_DROIDSIGHT_DEVICE_PIN> --env DROIDSIGHT_ALLOW_SHELL=<YOUR_DROIDSIGHT_ALLOW_SHELL> --env DROIDSIGHT_DEBUG_LOG=<YOUR_DROIDSIGHT_DEBUG_LOG> --env DROIDSIGHT_LOG=<YOUR_DROIDSIGHT_LOG> --env DROIDSIGHT_EVENTS=<YOUR_DROIDSIGHT_EVENTS> --env DROIDSIGHT_SENTINEL=<YOUR_DROIDSIGHT_SENTINEL> -- npx -y @edgecasehuman/droidsight