Servidor MCP de línea de comandos de Windows
Un servidor de Protocolo de contexto de modelo (MCP) seguro que permite que los modelos de IA interactúen con la funcionalidad de la línea de comandos de Windows de forma segura y eficiente.
Descripción general
El servidor MCP de línea de comandos de Windows proporciona una conexión robusta y segura 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 completa de comandos permitidos
- Validación de entrada estricta
- 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 en entornos de desarrollo seguros
- Soporte de comandos ampliado para flujos de trabajo de desarrollo
🖥 Capacidades de interacción del 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
Para instalar Windows Command Line MCP Server para Claude Desktop automáticamente a través de Smithery :
npx -y @smithery/cli install @alxspiker/Windows-Command-Line-MCP-Server --client claude
Prerrequisitos
- Node.js 16 o posterior
- npm o hilo
- 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 forma segura con la herramienta de creación de proyectos incorporada:
- Tipos de proyectos compatibles: React, Node.js, Python
- Proyectos creados en un directorio
~/AIProjects aislado
Herramientas disponibles
- execute_command : Ejecutar comandos CLI de Windows
- execute_powershell : Ejecutar scripts de PowerShell
- create_project : Crea nuevos proyectos de desarrollo de forma segura
- list_running_processes : Recuperar procesos activos del sistema
- get_system_info : Recopilar detalles de configuración del sistema
- get_network_info : Recuperar información del adaptador de red
- get_scheduled_tasks : enumera y consulta las tareas del sistema
- get_service_info : Administrar y consultar servicios de Windows
- list_allowed_commands : enumera todos los comandos que puede ejecutar el servidor
Uso con Claude para escritorio
Para utilizar este servidor con Claude for Desktop:
- Construya el servidor siguiendo las instrucciones de configuración anteriores
- 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 creado en el directorio dist .
- Reiniciar Claude para escritorio
- Ahora puedes usar las herramientas pidiéndole a Claude que realice operaciones del sistema de Windows
Consideraciones de seguridad
Comandos permitidos
De forma predeterminada, solo se permiten comandos seguros:
- Recuperación de información del sistema
- Configuración de red
- Gestión de procesos
- Interacciones de herramientas de desarrollo
Operaciones bloqueadas
Los comandos peligrosos siempre están bloqueados, incluidos:
- Formateo de disco
- Gestión de usuarios
- Apagado del sistema
- Modificaciones críticas del registro
Configuración
Personalice el comportamiento del servidor especificando comandos permitidos o utilizando indicadores 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
Contribuyendo
- Bifurcar el repositorio
- Crea tu rama de funciones (
git checkout -b feature/amazing-feature ) - Confirme sus cambios (
git commit -m 'Add some amazing feature' ) - Empujar a la rama (
git push origin feature/amazing-feature ) - Abrir una solicitud de extracción
Licencia
Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.
Expresiones de gratitud
- Inspirado en la especificación del Protocolo de Contexto de Modelo
- Desarrollado teniendo en cuenta la seguridad y la flexibilidad
Historial de versiones
- 0.3.0 : Se implementaron todas las herramientas mencionadas en README (información del sistema, información de la red, gestión de procesos, información del servicio)
- 0.2.0 : Se agregó creación de proyectos y herramientas de desarrollo ampliadas.
- 0.1.0 : Versión inicial con capacidades básicas de ejecución de comandos
Apoyo
Si tiene problemas, preguntas o sugerencias, abra un problema en GitHub.