Servidor MCP del Monitor de recursos del sistema

Un servidor MCP que proporciona a Claude capacidades de monitoreo del sistema en tiempo real, incluidas métricas de velocidad de CPU, memoria, disco, red, batería e Internet utilizando systeminformation y pruebas de velocidad de múltiples fuentes.

Herramientas

• obtener_uso_de_CPU

  • Recupera la carga actual de la CPU como porcentaje, incluido el uso general y por núcleo.

  • Entradas : Ninguna

  • Salida : Texto (por ejemplo, CPU Load: 12.34% (Cores: 10.50, 15.20, 8.90, 14.60%) )

• obtener_uso_de_memoria

  • Informa la memoria total, utilizada y libre en GB, además del porcentaje utilizado.

  • Entradas : Ninguna

  • Salida : Texto (por ejemplo, Memory: 65.43% used (7.82GB / 16.00GB) )

• obtener_espacio_en_disco

  • Muestra el uso del disco para la unidad más grande en GB y porcentaje.

  • Entradas : Ninguna

  • Salida : Texto (por ejemplo, Disk (/): 78.90% used (189.50GB / 250.00GB) )

• obtener_uso_de_red

  • Devuelve las velocidades RX/TX de la red en tiempo real (KB/s) y los datos totales desde el arranque (MB).

  • Entradas : Ninguna

  • Salida : Texto (por ejemplo, Network (eth0): RX: 25.50KB/s, TX: 10.20KB/s (Total: RX 150.34MB, TX 75.89MB) )

• obtener_estado_de_la_batería

  • Proporciona el porcentaje de carga de la batería, el estado de carga y el tiempo restante (si corresponde).

  • Entradas : Ninguna

  • Salida : Texto (por ejemplo, Battery: 85% (charging), 120 min remaining o No battery detected )

• obtener velocidad de internet

  • Mide la velocidad de Internet utilizando múltiples fuentes de descarga (incluido un archivo cargado por el usuario) y pruebas de carga, y devuelve velocidades medias en Mbps.

  • Entradas : Ninguna

  • Salida : Texto (por ejemplo, Internet Speed: Download 45.67Mbps, Upload 8.45Mbps )

Related MCP server: Hardware Monitor MCP Server

Configuración

Paso 1: Clonar e instalar

Clonar este repositorio:

git clone git@github.com:abhinav7895/system-mcp.git

Navegue hasta el directorio e instale las dependencias:

cd system-resource-monitor && npm install

Paso 2: Construir el proyecto

Compilar el código TypeScript:

npm run build

Esto genera el archivo dist/index.js , listo para ejecutarse como un servidor MCP.

Paso 3: Configurar Claude Desktop

1. Descargue Claude Desktop aquí .

2. Agregue esto a su claude_desktop_config.json :

{
  "mcpServers": {
    "system-resource-monitor": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js"]
    }
  }
}

Acceda al archivo de configuración:

vim ~/Library/Application\ Support/Claude/claude_desktop_config.json

(Ajuste la ruta a dist/index.js según la ubicación de su proyecto).

Paso 4: Prueba

Asegúrese de que Claude Desktop reconozca las herramientas verificando el ícono del martillo:

Haga clic en el icono del martillo para ver las herramientas disponibles:

Si aparecen las seis herramientas ( get_cpu_usage , get_memory_usage , etc.), la integración está activa. Ahora puede hacer preguntas como:

• "¿Cuál es mi uso de CPU?"

• "¿Qué tan rápido es mi Internet?"

Paso 5: Personalización avanzada

• Prueba de velocidad de Internet : modifique testUrls en index.ts para utilizar diferentes fuentes de descarga o ajuste uploadSizeBytes (predeterminado 80 KB) para las pruebas de carga.

• Registro : los registros de la consola proporcionan resultados de prueba detallados; deshabilítelos en producción eliminando las declaraciones console.log .

Solución de problemas

• Herramienta no se muestra : Verifique que el servidor esté ejecutándose ( node dist/index.js ) y que la ruta de configuración sea correcta.

• Errores de velocidad de Internet : Asegúrese de que la conectividad de red y las URL de prueba sean accesibles. Revise los registros de la consola para detectar errores específicos.

• Consulte la guía de solución de problemas de MCP

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Puede usar, modificar y distribuir el software libremente bajo los términos de la Licencia MIT. Consulte el archivo LICENSE para obtener más información.