iTerm

iterm-mcp

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso a tu sesión de iTerm.

Características

Uso eficiente de tokens: iterm-mcp le da al modelo la capacidad de inspeccionar solo la salida que le interesa. El modelo típicamente solo quiere ver las últimas líneas de salida, incluso para comandos de larga duración.

Integración natural: Compartes iTerm con el modelo. Puedes hacer preguntas sobre lo que está en la pantalla, o delegar una tarea al modelo y observar cómo realiza cada paso.

Control total del terminal y soporte REPL: El modelo puede iniciar e interactuar con REPL, así como enviar caracteres de control como ctrl-c, ctrl-z, etc.

Fácil con las dependencias: iterm-mcp está construido con dependencias mínimas y se puede ejecutar mediante npx. Está diseñado para ser fácil de añadir a Claude Desktop y otros clientes MCP. Debería funcionar sin problemas.

Consideraciones de seguridad

• El usuario es responsable de usar la herramienta de manera segura.
• Sin restricciones integradas: iterm-mcp no intenta evaluar la seguridad de los comandos que se ejecutan.
• Los modelos pueden comportarse de maneras inesperadas. Se espera que el usuario supervise la actividad y aborte cuando sea apropiado.
• Para tareas de múltiples pasos, es posible que necesites interrumpir al modelo si se desvía. Comienza con tareas más pequeñas y enfocadas hasta que te familiarices con el comportamiento del modelo.

Herramientas

• write_to_terminal - Escribe en el terminal iTerm activo, a menudo usado para ejecutar un comando. Devuelve el número de líneas de salida producidas por el comando.
• read_terminal_output - Lee el número solicitado de líneas del terminal iTerm activo.
• send_control_character - Envía un carácter de control al terminal iTerm activo.

Requisitos

• iTerm2 debe estar en ejecución
• Versión de Node 18 o superior

Instalación

Para usar con Claude Desktop, añade la configuración del servidor:

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

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

Instalación mediante Smithery

Para instalar iTerm para Claude Desktop automáticamente a través de Smithery:

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

Desarrollo

Instala las dependencias:

yarn install

Compila el servidor:

yarn run build

Para desarrollo con reconstrucción automática:

yarn run watch

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser desafiante. Recomendamos usar el Inspector MCP, que está disponible como un script de paquete:

yarn run inspector
yarn debug <command>

El Inspector proporcionará una URL para acceder a las herramientas de depuración en tu navegador.