Orbital

npm version Model Context Protocol License: MIT

The official Model Context Protocol (MCP) server for controlling, inspecting, and testing Android devices wirelessly in real-time from AI coding assistants (Antigravity, Claude Desktop, Cursor IDE, Windsurf, VS Code) using the Orbital Android App.

⚡ Zero-Install Quick Start (Recommended)

You don't need to clone the full Android codebase or install manual dependencies. Run @orbital_mcp/orbital-mcp instantly with npx:

npx -y @orbital_mcp/orbital-mcp

This launches the local bridge host with automatic IP discovery, QR code pairing, and mDNS network broadcasting:

================================================================
 🛰️  ORBITAL LAPTOP-TO-MOBILE AI BRIDGE (SECURE CRYPTO HOST)
================================================================
🔑 Pairing PIN   : ORB-7821
🔐 Crypto Key ID : 4A8F:B12C:99E1:F3D0 (256-bit Bitcoin-grade Auth)
🌐 Primary WSS   : wss://192.168.1.5:8765
📡 QuickShare NSD: _orbital-bridge._tcp (Laptop)
📱 Scan QR Code or Connect via Orbital App
================================================================

🛠️ AI IDE Configuration

1. Antigravity IDE (mcp_config.json)

{
  "mcpServers": {
    "orbital-phone": {
      "command": "npx",
      "args": ["-y", "@orbital_mcp/orbital-mcp"]
    }
  }
}

2. Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "orbital-phone": {
      "command": "npx",
      "args": ["-y", "@orbital_mcp/orbital-mcp"]
    }
  }
}

3. Cursor / Windsurf IDE

In Cursor Settings $\rightarrow$ Features $\rightarrow$ MCP Servers $\rightarrow$ Add New:

• Name: orbital-phone
• Type: command
• Command: npx -y @orbital_mcp/orbital-mcp

📱 Connect Your Android Device

1. Install the Orbital Android Companion APK.
2. Grant Accessibility Service permission on the phone.
3. Open the side menu $\rightarrow$ tap Laptop AI Bridge.
4. Scan the QR code displayed in your terminal or enter the 4-digit PIN.
5. The device connects immediately over an encrypted WebSocket tunnel.

🧰 Full Suite of 13 MCP Tools

🧪 Automated App Testing & QA

With @orbital_mcp/orbital-mcp, agents can perform end-to-end multi-step verification on physical Android devices:

{
  "planTitle": "Settings Display QA Flow",
  "steps": [
    { "actionType": "OPEN_APP", "packageName": "Settings", "delayAfterMs": 800, "assertionText": "Settings" },
    { "actionType": "CLICK_NODE", "targetText": "Display", "delayAfterMs": 500 },
    { "actionType": "INSPECT_SCREEN" },
    { "actionType": "PRESS_KEY", "keyCode": "HOME" }
  ]
}

🔒 Security & Privacy

• 100% Local: Direct peer-to-peer WebSocket tunnel over your local network. No external servers or cloud middleman.
• HMAC-SHA256 Authorization: Every incoming MCP command is authenticated with a 256-bit cryptographic signature covering action parameters, timestamps, and nonces.
• Payment App Shield: Automatically conceals and freezes when banking or payment apps are active.

📂 Repositories & Resources

• Standalone MCP Repository: https://github.com/jaypal1046/orbital_mcp (Direct clone for MCP-only developers)
• Full Monorepo (Android App + Engine): https://github.com/jaypal1046/Orbital
• Privacy Policy & Security Terms: https://github.com/jaypal1046/orbital_policy
• Zero-Install NPX Package: npx -y @orbital_mcp/orbital-mcp
• License: MIT