Frida MCP

Instructions

Returns:
    Information about the USB device

Implementation Reference

• src/frida_mcp/cli.py:287-302 (handler)

  MCP tool handler for 'get_usb_device'. Retrieves the USB-connected Frida device directly using frida.get_usb_device() and returns its ID, name, and type, or raises ValueError if no USB device is found.

  @mcp.tool()
  def get_usb_device() -> Dict[str, Any]:
      """Get the USB device connected to the system.
  
      Returns:
          Information about the USB device
      """
      try:
          device = frida.get_usb_device()
          return {
              "id": device.id,
              "name": device.name,
              "type": device.type,
          }
      except frida.InvalidArgumentError:
          raise ValueError("No USB device found")

• src/frida_mcp/device_selection.py:277-281 (helper)

  Supporting helper method in DeviceSelector for retrieving the USB device, used in device resolution logic (e.g., when device_id='usb').

  def _get_usb_device(self) -> Any:
      try:
          return self._frida.get_usb_device()
      except self._frida.InvalidArgumentError as exc:  # type: ignore[attr-defined]
          raise DeviceSelectionError("No USB devices detected") from exc

• src/frida_mcp/device_selection.py:249-249 (helper)

  Call to _get_usb_device helper within _get_by_identifier method when identifier is 'usb'.

  return self._get_usb_device()