PicoScope MCP Server

Instructions

Implementation Reference

• src/picoscope_mcp/tools/discovery.py:80-120 (handler)

  The handler function for the 'get_device_info' tool. It checks if a device is connected, retrieves device information using device_manager.get_info(), and returns a structured dictionary with status and device details.

  @mcp.tool()
  def get_device_info() -> dict[str, Any]:
      """Get detailed information about the currently connected device.
  
      Returns:
          Dictionary containing device model, serial, variant, capabilities, etc.
      """
      try:
          if not device_manager.is_connected():
              return {
                  "status": "error",
                  "error": "No device connected",
                  "connected": False,
              }
  
          info = device_manager.get_info()
          if info:
              return {
                  "status": "success",
                  "connected": True,
                  "device": {
                      "model": info.model,
                      "serial": info.serial,
                      "variant": info.variant,
                      "batch_and_serial": info.batch_and_serial,
                      "num_channels": info.num_channels,
                      "max_adc_value": info.max_adc_value,
                      "min_adc_value": info.min_adc_value,
                  },
              }
          else:
              return {
                  "status": "error",
                  "error": "Failed to retrieve device info",
              }
  
      except Exception as e:
          return {
              "status": "error",
              "error": str(e),
          }

• src/picoscope_mcp/server.py:15-15 (registration)

  Invocation of register_discovery_tools which defines and registers the get_device_info tool using the @mcp.tool() decorator.

  register_discovery_tools(mcp)