ITerm MCP Server

Un servidor MCP para iTerm2, que permite a los asistentes de IA interactuar con la terminal.

Documentación

ITerm MCP Server

Una implementación de servidor de Model Context Protocol (MCP) para la integración de terminales iTerm2. Este servidor permite a los asistentes de IA interactuar con terminales iTerm2 a través del Model Context Protocol.

Características

  • Crear y gestionar sesiones de terminal iTerm2
  • Ejecutar comandos en terminales
  • Leer la salida de la terminal
  • Listar terminales activas
  • Cerrar terminales

Requisitos

  • Node.js >= 14.x
  • iTerm2
  • macOS (ya que iTerm2 es exclusivo de macOS)

Configuración

Configuración estándar

El servidor utiliza las opciones de configuración estándar de MCP. No se requiere configuración adicional.

Configuración de Cursor

Para usar este servidor con Cursor, añade la siguiente configuración a tu archivo ~/.cursor/mcp.json:

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

Herramientas

  • open_terminal: Abrir una nueva instancia de terminal
  • execute_command: Ejecutar un comando en una terminal específica
  • read_output: Leer la salida de una terminal específica
  • close_terminal: Cerrar una terminal específica
  • list_terminals: Listar todas las terminales activas y su información

Consideraciones de seguridad

  • El servidor valida toda la entrada mediante esquemas Zod
  • Los comandos se ejecutan en sesiones de terminal aisladas
  • Se implementa un manejo adecuado de errores y saneamiento de entrada

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar un Pull Request.

Licencia

ISC

Autor

Rishab Koul