local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Provides access to the user's iTerm terminal session, allowing the model to read terminal output, write commands to the terminal, and send control characters for full terminal control.

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

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

Instalación mediante herrería

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

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

Desarrollo

Instalar dependencias:

yarn install

Construir 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 complicada. Recomendamos usar el Inspector MCP , disponible como script de paquete:

yarn run inspector
yarn debug <command>

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

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

Este servidor MCP permite a los usuarios ejecutar comandos de shell en la sesión iTerm2 actual a través de la integración con Claude Desktop, lo que facilita la ejecución perfecta de comandos a través del Protocolo de contexto de modelo.

Related Resources

Reddit Discussion about this server

iTerm MCP Server