ITerm MCP Server

Um servidor MCP para iTerm2, permitindo que assistentes de IA interajam com o terminal.

Documentação

Servidor MCP ITerm

Uma implementação de servidor Model Context Protocol (MCP) para integração com o terminal iTerm2. Este servidor permite que assistentes de IA interajam com terminais iTerm2 por meio do Model Context Protocol.

Recursos

  • Criar e gerenciar sessões de terminal iTerm2
  • Executar comandos em terminais
  • Ler a saída do terminal
  • Listar terminais ativos
  • Fechar terminais

Requisitos

  • Node.js >= 14.x
  • iTerm2
  • macOS (já que o iTerm2 é exclusivo para macOS)

Configuração

Configuração Padrão

O servidor usa as opções de configuração padrão do MCP. Nenhuma configuração adicional é necessária.

Configuração do Cursor

Para usar este servidor com o Cursor, adicione a seguinte configuração ao seu arquivo ~/.cursor/mcp.json:

{
  "mcpServers": {
    "terminal": {
      "command": "npx",
      "args": ["iterm_mcp_server"]
    }
  }
}

Ferramentas

  • open_terminal: Abrir uma nova instância de terminal
  • execute_command: Executar um comando em um terminal específico
  • read_output: Ler a saída de um terminal específico
  • close_terminal: Fechar um terminal específico
  • list_terminals: Listar todos os terminais ativos e suas informações

Considerações de Segurança

  • O servidor valida todas as entradas usando esquemas Zod
  • Os comandos são executados em sessões de terminal isoladas
  • Tratamento adequado de erros e sanitização de entrada são implementados

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Licença

ISC

Autor

Rishab Koul