Android MCP Server

Instructions

Implementation Reference

• src/adb/device-manager.ts:34-64 (handler)

  The core implementation of device listing, which executes 'adb devices -l'.

  /**
   * List all connected devices.
   */
  async listDevices(): Promise<DeviceInfo[]> {
    const result = await adbExec(['devices', '-l']);
    const lines = result.stdout.split('\n').filter(l => l.trim() && !l.startsWith('List'));
  
    const devices: DeviceInfo[] = [];
    for (const line of lines) {
      const parts = line.trim().split(/\s+/);
      if (parts.length >= 2) {
        const id = parts[0];
        const status = parts[1];
  
        // Parse device properties from -l output
        const props: Record<string, string> = {};
        for (const part of parts.slice(2)) {
          const [key, value] = part.split(':');
          if (key && value) props[key] = value;
        }
  
        devices.push({
          id,
          status,
          model: props['model'],
        });
      }
    }
  
    return devices;
  }

• src/controllers/device-tools.ts:23-41 (registration)

  Registration of the 'list_devices' tool in the MCP server.

  export function registerDeviceTools(server: McpServer): void {
    server.registerTool(
      'list_devices',
      {
        description: 'List all connected Android devices with their status and model information',
        inputSchema: {},
      },
      async () => {
        return await metrics.measure('list_devices', 'all', async () => {
          const devices = await deviceManager.listDevices();
          return {
            content: [{
              type: 'text' as const,
              text: JSON.stringify({ success: true, devices }, null, 2),
            }],
          };
        });
      }
    );