Windows Command Line MCP Server

by alxspiker
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Provides access to Git commands for version control within the allowlist of permitted operations

  • Allows project creation and management for Node.js applications in a sandboxed environment

  • Allows execution of npm commands for package management within the security constraints

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

Instalación mediante herrería

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

  1. execute_command : Ejecutar comandos CLI de Windows
  2. execute_powershell : Ejecutar scripts de PowerShell
  3. create_project : Crea nuevos proyectos de desarrollo de forma 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 del adaptador de red
  7. get_scheduled_tasks : Listar y consultar tareas del sistema
  8. get_service_info : Administrar y consultar servicios de Windows
  9. 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:

  1. Construya 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 creado en el directorio dist .

  1. Reiniciar Claude para escritorio
  2. 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

  1. Bifurcar el repositorio
  2. Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
  3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )
  4. Empujar a la rama ( git push origin feature/amazing-feature )
  5. 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.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Un servidor de protocolo de contexto de modelo seguro que permite que los modelos de IA interactúen de forma segura con la funcionalidad de la línea de comandos de Windows, lo que permite la ejecución controlada de comandos del sistema, la creación de proyectos y la recuperación de información del sistema.

  1. Overview
    1. Key Features
      1. 🔒 Enhanced Security
      2. 🛠 Development Tools Support
      3. 🖥 System Interaction Capabilities
    2. Installation
      1. Installing via Smithery
      2. Prerequisites
      3. Setup
    3. Usage
      1. Command Line Options
      2. Project Creation
      3. Available Tools
    4. Using with Claude for Desktop
      1. Security Considerations
        1. Allowed Commands
        2. Blocked Operations
      2. Configuration
        1. Example
      3. Contributing
        1. License
          1. Acknowledgements
            1. Version History
              1. Support
                ID: 976txj1j30