Windows Command Line MCP Server

Permite que los modelos de IA interactúen con la línea de comandos de Windows de manera segura y eficiente.

GitHub
10
Prueba este MCPPatrocinado

Documentación

MseeP Badge

Servidor MCP de Línea de Comandos de Windows

Un servidor seguro del Protocolo de Contexto de Modelo (MCP) que permite a los modelos de IA interactuar con la funcionalidad de la línea de comandos de Windows de manera segura y eficiente.

Version License: MIT smithery badge

Descripción General

El Servidor MCP de Línea de Comandos de Windows proporciona un puente robusto y seguro entre los modelos de IA y las operaciones del sistema Windows. Permite la ejecución controlada de comandos, la creación de proyectos y la recuperación de información del sistema, manteniendo estrictos protocolos de seguridad.

Características Principales

🔒 Seguridad Mejorada

  • Lista de comandos permitidos integral
  • Validación estricta de entrada
  • Prevención de operaciones destructivas del sistema
  • Niveles de seguridad configurables

🛠 Soporte de Herramientas de Desarrollo

  • Creación de proyectos para React, Node.js y Python
  • Interacciones seguras con el entorno de desarrollo
  • Soporte ampliado de comandos para flujos de trabajo de desarrollo

🖥 Capacidades de Interacción con el Sistema

  • Ejecutar comandos CLI de Windows
  • Ejecutar scripts de PowerShell
  • Recuperar información del sistema y de la red
  • Gestionar procesos y servicios

Instalación

Instalación mediante Smithery

Para instalar el Servidor MCP de Línea de Comandos de Windows para Claude Desktop automáticamente a través de Smithery:

npx -y @smithery/cli install @alxspiker/Windows-Command-Line-MCP-Server --client claude

Requisitos Previos

  • Node.js 16 o posterior
  • npm o yarn
  • Sistema operativo Windows

Configuración

git clone https://github.com/alxspiker/Windows-Command-Line-MCP-Server.git
cd Windows-Command-Line-MCP-Server
npm install
npm run build

Uso

Opciones de Línea de Comandos

  • Modo predeterminado: Utiliza comandos seguros predefinidos
  • --allow-all: Ejecutar en modo extendido (con precauciones adicionales)
  • Se pueden especificar listas de comandos personalizadas como argumentos

Creación de Proyectos

Cree nuevos proyectos de manera segura con la herramienta integrada de creación de proyectos:

  • Tipos de proyectos compatibles: React, Node.js, Python
  • Los proyectos se crean en un directorio ~/AIProjects en entorno aislado

Herramientas Disponibles

  1. execute_command: Ejecutar comandos CLI de Windows
  2. execute_powershell: Ejecutar scripts de PowerShell
  3. create_project: Crear nuevos proyectos de desarrollo de manera segura
  4. list_running_processes: Recuperar procesos activos del sistema
  5. get_system_info: Recopilar detalles de configuración del sistema
  6. get_network_info: Recuperar información de adaptadores de red
  7. get_scheduled_tasks: Listar y consultar tareas del sistema
  8. get_service_info: Gestionar y consultar servicios de Windows
  9. list_allowed_commands: Listar todos los comandos que el servidor puede ejecutar

Uso con Claude para Desktop

Para usar este servidor con Claude para Desktop:

  1. Compile el servidor siguiendo las instrucciones de configuración anteriores
  2. Agréguelo a su claude_desktop_config.json:
{
  "mcpServers": {
    "windows-cmd": {
      "command": "node",
      "args": ["/path/to/dist/index.js"]
    }
  }
}

Reemplace /path/to/dist/index.js con la ruta absoluta al archivo index.js compilado en el directorio dist.

  1. Reinicie Claude para Desktop
  2. Ahora puede usar las herramientas pidiéndole a Claude que realice operaciones del sistema Windows

Consideraciones de Seguridad

Comandos Permitidos

Por defecto, solo se permiten comandos seguros:

  • Recuperación de información del sistema
  • Configuración de red
  • Gestión de procesos
  • Interacciones con herramientas de desarrollo

Operaciones Bloqueadas

Los comandos peligrosos siempre están bloqueados, incluyendo:

  • Formateo de discos
  • Gestión de usuarios
  • Apagado del sistema
  • Modificaciones críticas del registro

Configuración

Personalice el comportamiento del servidor especificando comandos permitidos o utilizando banderas de configuración.

Ejemplo

# Run with default safe commands
node dist/index.js

# Run with specific allowed commands
node dist/index.js dir echo npm git

# Run in extended mode (use with caution)
node dist/index.js --allow-all

Contribuciones

  1. Haga un fork del repositorio
  2. Cree su rama de características (git checkout -b feature/amazing-feature)
  3. Realice sus cambios (git commit -m 'Add some amazing feature')
  4. Envíe los cambios a la rama (git push origin feature/amazing-feature)
  5. Abra una Solicitud de Extracción

Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulte el archivo LICENSE para más detalles.

Agradecimientos

  • Inspirado en la especificación del Protocolo de Contexto de Modelo
  • Desarrollado con seguridad y flexibilidad en mente

Historial de Versiones

  • 0.3.0: Implementadas todas las herramientas mencionadas en el README (información del sistema, información de red, gestión de procesos, información de servicios)
  • 0.2.0: Añadida creación de proyectos, herramientas de desarrollo ampliadas
  • 0.1.0: Versión inicial con capacidades básicas de ejecución de comandos

Soporte

Para problemas, preguntas o sugerencias, por favor abra un problema en GitHub.