iterm-mcp
Updated at 15 days ago
by ferrislucas
83
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
- Install the script: Download the
mcp.py
script and place it in a convenient location on your system. - 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.
- Define Commands: MCP reads a JSON file (
commands.json
by default) that defines the commands you want to execute. The script looks forcommands.json
in the same directory as the MCP script.- The
commands.json
file should be formatted like this:
- The