System Information MCP Server

Instructions

Implementation Reference

• src/sysinfo/server.py:211-229 (handler)

  MCP tool handler decorated with @mcp.tool. Imports and calls the collectors.get_display_info helper, formats output with timestamp and error handling, returns ToolResult.

  @mcp.tool
  def get_display_info() -> ToolResult:
      """Get connected display information - resolution, refresh rate, HDR status.
      
      Shows details for all connected monitors including resolution, refresh rates,
      connection types, and HDR capabilities. Essential for display troubleshooting
      and multi-monitor setup verification.
      """
      info_sections = []
      info_sections.append("# Display Information")
      info_sections.append(f"*Generated: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}*\n")
      
      try:
          from .collectors import get_display_info as get_display_data
          info_sections.extend(get_display_data())
      except Exception as e:
          info_sections.append(f"⚠️ **Display detection error**: {str(e)}")
      
      return text_response("\n".join(info_sections))

• src/sysinfo/collectors.py:199-243 (helper)

  Main helper function collecting display information using platform-specific methods (_get_macos_displays, _get_linux_displays, _get_windows_displays). Returns formatted list of strings with display details.

  def get_display_info() -> List[str]:
      """Get display/monitor information - resolution, refresh rate, HDR status"""
      info = []
      info.append("## 🖥️ Display Information")
      
      try:
          if platform.system() == "Darwin":
              # macOS display detection
              displays = _get_macos_displays()
              if displays:
                  for i, display in enumerate(displays, 1):
                      info.append(f"\n### Display {i}")
                      for key, value in display.items():
                          info.append(f"- **{key}**: {value}")
              else:
                  info.append("- **Status**: No displays detected")
                  
          elif platform.system() == "Linux":
              # Linux display detection
              displays = _get_linux_displays()
              if displays:
                  for i, display in enumerate(displays, 1):
                      info.append(f"\n### Display {i}")
                      for key, value in display.items():
                          info.append(f"- **{key}**: {value}")
              else:
                  info.append("- **Status**: No displays detected")
                  
          elif platform.system() == "Windows":
              # Windows display detection
              displays = _get_windows_displays()
              if displays:
                  for i, display in enumerate(displays, 1):
                      info.append(f"\n### Display {i}")
                      for key, value in display.items():
                          info.append(f"- **{key}**: {value}")
              else:
                  info.append("- **Status**: No displays detected")
          else:
              info.append("- **Status**: Display detection not supported on this platform")
              
      except Exception as e:
          info.append(f"⚠️ **Display detection error**: {str(e)}")
      
      return info