Windows Command Line MCP Server

Permite que modelos de IA interajam com a linha de comando do Windows de forma segura e eficiente.

GitHub
10
Experimente este MCPPatrocinado

Documentação

MseeP Badge

Windows Command Line MCP Server

Um servidor seguro do Model Context Protocol (MCP) que permite que modelos de IA interajam com a funcionalidade de linha de comando do Windows de forma segura e eficiente.

Version License: MIT smithery badge

Visão Geral

O Windows Command Line MCP Server fornece uma ponte robusta e segura entre modelos de IA e operações do sistema Windows. Ele permite execução controlada de comandos, criação de projetos e recuperação de informações do sistema, mantendo protocolos de segurança rigorosos.

Principais Recursos

🔒 Segurança Aprimorada

  • Lista de permissões abrangente de comandos
  • Validação rigorosa de entrada
  • Prevenção de operações destrutivas no sistema
  • Níveis de segurança configuráveis

🛠 Suporte a Ferramentas de Desenvolvimento

  • Criação de projetos para React, Node.js e Python
  • Interações seguras com o ambiente de desenvolvimento
  • Suporte expandido a comandos para fluxos de trabalho de desenvolvimento

🖥 Capacidades de Interação com o Sistema

  • Executar comandos CLI do Windows
  • Executar scripts PowerShell
  • Recuperar informações do sistema e da rede
  • Gerenciar processos e serviços

Instalação

Instalando via Smithery

Para instalar o Windows Command Line MCP Server para Claude Desktop automaticamente via Smithery:

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

Pré-requisitos

  • Node.js 16 ou posterior
  • npm ou yarn
  • Sistema operacional Windows

Configuração

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

Uso

Opções de Linha de Comando

  • Modo padrão: usa comandos seguros predefinidos
  • --allow-all: Executar em modo estendido (com precauções adicionais)
  • Listas de comandos personalizadas podem ser especificadas como argumentos

Criação de Projetos

Crie novos projetos com segurança usando a ferramenta integrada de criação de projetos:

  • Tipos de projeto suportados: React, Node.js, Python
  • Projetos criados em um diretório ~/AIProjects em sandbox

Ferramentas Disponíveis

  1. execute_command: Executar comandos CLI do Windows
  2. execute_powershell: Executar scripts PowerShell
  3. create_project: Criar novos projetos de desenvolvimento com segurança
  4. list_running_processes: Recuperar processos ativos do sistema
  5. get_system_info: Coletar detalhes de configuração do sistema
  6. get_network_info: Recuperar informações do adaptador de rede
  7. get_scheduled_tasks: Listar e consultar tarefas do sistema
  8. get_service_info: Gerenciar e consultar serviços do Windows
  9. list_allowed_commands: Listar todos os comandos que podem ser executados pelo servidor

Usando com Claude for Desktop

Para usar este servidor com Claude for Desktop:

  1. Compile o servidor usando as instruções de configuração acima
  2. Adicione-o ao seu claude_desktop_config.json:
{
  "mcpServers": {
    "windows-cmd": {
      "command": "node",
      "args": ["/path/to/dist/index.js"]
    }
  }
}

Substitua /path/to/dist/index.js pelo caminho absoluto para o arquivo index.js compilado no diretório dist.

  1. Reinicie o Claude for Desktop
  2. Agora você pode usar as ferramentas pedindo ao Claude para realizar operações no sistema Windows

Considerações de Segurança

Comandos Permitidos

Por padrão, apenas comandos seguros são permitidos:

  • Recuperação de informações do sistema
  • Configuração de rede
  • Gerenciamento de processos
  • Interações com ferramentas de desenvolvimento

Operações Bloqueadas

Comandos perigosos são sempre bloqueados, incluindo:

  • Formatação de disco
  • Gerenciamento de usuários
  • Desligamento do sistema
  • Modificações críticas no registro

Configuração

Personalize o comportamento do servidor especificando comandos permitidos ou usando flags de configuração.

Exemplo

# 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

Contribuindo

  1. Faça um fork do repositório
  2. Crie sua branch de recurso (git checkout -b feature/amazing-feature)
  3. Faça commit das suas alterações (git commit -m 'Add some amazing feature')
  4. Envie para a branch (git push origin feature/amazing-feature)
  5. Abra um Pull Request

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para detalhes.

Agradecimentos

  • Inspirado pela especificação do Model Context Protocol
  • Desenvolvido com segurança e flexibilidade em mente

Histórico de Versões

  • 0.3.0: Implementadas todas as ferramentas mencionadas no README (informações do sistema, informações de rede, gerenciamento de processos, informações de serviços)
  • 0.2.0: Adicionada criação de projetos, ferramentas de desenvolvimento expandidas
  • 0.1.0: Lançamento inicial com capacidades básicas de execução de comandos

Suporte

Para problemas, perguntas ou sugestões, por favor abra uma issue no GitHub.