iTerm MCP Server

iterm-mcp

Un servidor de protocolo de contexto de modelo que proporciona acceso a su sesión de iTerm.

Características

Uso eficiente del token: iterm-mcp brinda al modelo la capacidad de inspeccionar solo la salida que le interesa. El modelo normalmente solo quiere ver las últimas líneas de salida, incluso para comandos de ejecución prolongada.

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

Control de terminal completo y soporte REPL: el modelo puede iniciar e interactuar con REPL, así como enviar caracteres de control como Ctrl-C, Ctrl-Z, etc.

Dependencias mínimas: iterm-mcp se compila con dependencias mínimas y se ejecuta mediante npx. Está diseñado para ser fácil de integrar en Claude Desktop y otros clientes MCP. Debería funcionar sin problemas.

Consideraciones de seguridad

• El usuario es responsable de utilizar la herramienta de forma segura.
• Sin restricciones integradas: iterm-mcp no intenta evaluar la seguridad de los comandos que se ejecutan.
• Los modelos pueden comportarse de forma inesperada. Se espera que el usuario supervise la actividad y la cancele cuando corresponda.
• En tareas de varios pasos, es posible que tengas que interrumpir el modelo si se desvía. Empieza con tareas más pequeñas y específicas hasta que te familiarices con el comportamiento del modelo.

Herramientas

• write_to_terminal : escribe en la terminal iTerm activa, que suele usarse para ejecutar un comando. Devuelve el número de líneas de salida generadas por el comando.
• read_terminal_output : lee la cantidad de líneas solicitadas desde la terminal iTerm activa.
• send_control_character : envía un carácter de control a la terminal iTerm activa.

Requisitos

• iTerm2 debe estar ejecutándose
• Versión de nodo 18 o superior

Instalación

Para utilizar con Claude Desktop, agregue la configuración del servidor:

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

Instalación mediante herrería

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

Desarrollo

Instalar dependencias:

Construir el servidor:

Para desarrollo con reconstrucción automática:

Depuración

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

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