Updated at 15 days ago

by ferrislucas

83

star

on GitHub

A Model Context Protocol server that executes commands in the current iTerm session - useful for REPL and CLI assistance

Tags

ai

claude

claude-ai

mcp

mcp-server

repl

What is iTerm MCP (Multi Command Palette)

iTerm MCP (Multi Command Palette) is an iTerm2 script that allows you to execute multiple commands simultaneously in separate iTerm2 panes/tabs. It provides a user-friendly interface to define and run sets of commands, streamlining workflows that involve multiple terminal interactions.

How to use

  1. Install the script: Download the mcp.py script and place it in a convenient location on your system.
  2. Configure iTerm2:
    • Open iTerm2 preferences.
    • Go to "Scripts."
    • Add a new script entry.
    • Set "Script Name" to something descriptive (e.g., "MCP").
    • Set "Language" to "Python".
    • Set "Location" to the path where you saved mcp.py.
    • Optionally, assign a hotkey to the script in the "Keys" tab to quickly launch the command palette.
  3. Define Commands: MCP reads a JSON file (commands.json by default) that defines the commands you want to execute. The script looks for commands.json in the same directory as the MCP script.
    • The commands.json file should be formatted like this:

View More