G1 UART MCP Server

Instructions

Implementation Reference

• mcp_server.py:226-271 (handler)

  The primary handler for the get_g1_connection_status tool. Registered via @server.tool() decorator. Retrieves status from BLE manager and formats the response dictionary with connection details.
  @server.tool() async def get_g1_connection_status() -> Dict[str, Any]: """Get current connection status and device info. Returns: Dict[str, Any]: JSON response with detailed connection status including: - result: "success" or "error" - connected: Boolean indicating connection state - device_name: Name of connected device (if connected) - device_address: Address of connected device (if connected) - uart_service_available: Boolean indicating UART service availability - tx_characteristic_available: Boolean indicating TX characteristic availability - rx_characteristic_available: Boolean indicating RX characteristic availability - pending_messages_count: Number of pending messages - total_messages: Total message count - error: Error message if status check failed Note: This returns detailed status information including: - Connection state (connected/disconnected) - Device name and address (if connected) - UART service availability - Number of pending messages - Total message count """ try: status = ble_manager.get_connection_status() except Exception as e: logger.error(f"Status check failed: {e}") return { "result": "error", "connected": False, "error": f"Status check failed: {str(e)}" } return { "result": "success", "connected": status['connected'], "device_name": status.get('device_name'), "device_address": status.get('device_address'), "uart_service_available": status.get('uart_service_available', False), "tx_characteristic_available": status.get('tx_characteristic_available', False), "rx_characteristic_available": status.get('rx_characteristic_available', False), "pending_messages_count": status.get('pending_messages_count', 0), "total_messages": status.get('total_messages', 0) }
• g1_uart_manager.py:371-394 (helper)

  Supporting helper method in NordicBLEUARTManager class that provides the detailed connection status data used by the tool handler.
  def get_connection_status(self) -> Dict[str, Any]: """Get current connection status and device info""" connection_duration = None if self.connection_start_time: connection_duration = (datetime.now() - self.connection_start_time).total_seconds() last_activity = None if self.last_activity_time: last_activity = (datetime.now() - self.last_activity_time).total_seconds() return { "connected": self.is_connected, "device_name": self.target_device.name if self.target_device else None, "device_address": self.target_device.address if self.target_device else None, "uart_service_available": self.uart_service is not None, "tx_characteristic_available": self.tx_characteristic is not None, "rx_characteristic_available": self.rx_characteristic is not None, "pending_messages_count": len(self.pending_messages), "total_messages": len(self.communication_log), "connection_duration_seconds": connection_duration, "last_activity_seconds": last_activity, "reconnect_attempts": self.reconnect_attempts, "auto_reconnect_enabled": self.auto_reconnect_enabled }