iTerm

iterm-mcp

Um servidor Model Context Protocol que fornece acesso à sua sessão do iTerm.

Recursos

Uso Eficiente de Tokens: o iterm-mcp dá ao modelo a capacidade de inspecionar apenas a saída que interessa ao modelo. O modelo normalmente só quer ver as últimas linhas da saída, mesmo para comandos de longa duração.

Integração Natural: Você compartilha o iTerm com o modelo. Você pode fazer perguntas sobre o que está na tela ou delegar uma tarefa ao modelo e observar enquanto ele executa cada etapa.

Controle Total do Terminal e Suporte a REPL: O modelo pode iniciar e interagir com REPLs, além de enviar caracteres de controle como ctrl-c, ctrl-z, etc.

Leve nas Dependências: o iterm-mcp é construído com dependências mínimas e pode ser executado via npx. Ele foi projetado para ser fácil de adicionar ao Claude Desktop e a outros clientes MCP. Deve funcionar sem problemas.

Considerações de Segurança

• O usuário é responsável por usar a ferramenta com segurança.
• Sem restrições embutidas: o iterm-mcp não faz nenhuma tentativa de avaliar a segurança dos comandos executados.
• Modelos podem se comportar de maneiras inesperadas. Espera-se que o usuário monitore a atividade e interrompa quando apropriado.
• Para tarefas de várias etapas, talvez seja necessário interromper o modelo se ele sair do caminho. Comece com tarefas menores e focadas até se familiarizar com o comportamento do modelo.

Ferramentas

• write_to_terminal - Escreve no terminal iTerm ativo, geralmente usado para executar um comando. Retorna o número de linhas de saída produzidas pelo comando.
• read_terminal_output - Lê o número solicitado de linhas do terminal iTerm ativo.
• send_control_character - Envia um caractere de controle para o terminal iTerm ativo.

Requisitos

• O iTerm2 deve estar em execução
• Node versão 18 ou superior

Instalação

Para usar com o Claude Desktop, adicione a configuração do servidor:

No macOS: ~/Library/Application Support/Claude/claude_desktop_config.json No Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "iterm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "iterm-mcp"
      ]
    }
  }
}

Instalação via Smithery

Para instalar o iTerm para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install iterm-mcp --client claude

Desenvolvimento

Instale as dependências:

yarn install

Compile o servidor:

yarn run build

Para desenvolvimento com recompilação automática:

yarn run watch

Depuração

Como os servidores MCP se comunicam via stdio, a depuração pode ser desafiadora. Recomendamos usar o MCP Inspector, que está disponível como um script de pacote:

yarn run inspector
yarn debug <command>

O Inspector fornecerá uma URL para acessar as ferramentas de depuração no seu navegador.