WinTerm MCP

WinTerm MCP

Um servidor Model Context Protocol que fornece acesso programático ao terminal do Windows. Este servidor permite que modelos de IA interajam com a interface de linha de comando do Windows por meio de um conjunto de ferramentas padronizadas.

Recursos

• Escrever no Terminal: Executar comandos ou escrever texto no terminal do Windows
• Ler Saída do Terminal: Recuperar a saída de comandos executados anteriormente
• Enviar Caracteres de Controle: Enviar sinais de controle (ex.: Ctrl+C) para o terminal
• Nativo do Windows: Construído especificamente para interação com a linha de comando do Windows

Instalação

1. Clonar o Repositório:

   git clone https://github.com/capecoma/winterm-mcp.git
   cd winterm-mcp
   

2. Instalar Dependências:

   npm install
   

3. Compilar o Projeto:

   npm run build
   

4. Configurar o Claude Desktop:

Adicione a configuração do servidor ao %APPDATA%/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "github.com/capecoma/winterm-mcp": {
      "command": "node",
      "args": ["path/to/build/index.js"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Nota: Substitua "path/to/build/index.js" pelo caminho real do seu arquivo index.js compilado.

Ferramentas Disponíveis

write_to_terminal

Escreve texto ou comandos no terminal.

{
  "command": "echo Hello, World!"
}

read_terminal_output

Lê o número especificado de linhas da saída do terminal.

{
  "linesOfOutput": 5
}

send_control_character

Envia um caractere de controle para o terminal (ex.: Ctrl+C).

{
  "letter": "C"
}

Desenvolvimento

Para desenvolvimento com recompilação automática:

npm run dev

Licença

Licença MIT - consulte o arquivo LICENSE.