Iterm MCP Server

🚀 iTerm MCP Server

An implementation of the Model Context Protocol (MCP) server for iTerm2 terminal integration. This server enables AI assistants to interact with the iTerm2 terminal via the Model Context Protocol.

🚀 Quick Start

The iTerm MCP Server allows AI assistants to interact with the iTerm2 terminal. It provides a series of features to manage terminal sessions and execute commands.

✨ Features

• Create and manage iTerm2 terminal sessions.
• Execute commands in the terminal.
• Read terminal output.
• List active terminals.
• Close terminals.

📦 Installation

Requirements

• Node.js >= 14.x
• iTerm2
• macOS (since iTerm2 is limited to macOS)

📚 Documentation

Configuration

Standard Configuration

The server uses standard MCP configuration options. No additional configuration is required.

Cursor Configuration

To use this server in Cursor, add the following configuration to the ~/.cursor/mcp.json file:

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

Tools

• open_terminal: Open a new terminal instance.
• execute_command: Execute a command in a specific terminal.
• read_output: Read the output of a specific terminal.
• close_terminal: Close a specific terminal.
• list_terminals: List all active terminals and their information.

🔧 Technical Details

Security Considerations

• The server validates all inputs using Zod schemas.
• Commands are executed in isolated terminal sessions.
• Appropriate security handling and input sanitization are implemented.

🤝 Contribution Guidelines

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

ISC

👨‍💻 Author

Rishab Koul