MCP Terminal

• MCP SDK

• - **iTerm2 ** macOS iTerm2 Python API - **AppleScript ** macOS AppleScript Terminal - **Subprocess **

• - **STDIO ** / - **SSE ** Server-Sent Events HTTP API

• Claude Desktop

• Python 3.8+

• [uv](https://github.com/astral-sh/uv) uv

uv

Makefile

MCP

Claude Desktop

• `--controller` `-c` auto, iterm, applescript, subprocess

• `--mode` `-m` stdio, sse

• `--host` SSE

• `--port` `-p` SSE

• `--log-level` `-l`

Claude Desktop

1. ** MCP Terminal ** stdio ```bash # make run-stdio ```

2. ** Claude Desktop MCP ** Claude Desktop - - " " " " - " " - MCP Terminal - Terminal - mcp_terminal.py - stdio -

3. ** ** Claude Claude - " " - " Python " - " "

4. MCP Terminal

6. Claude Desktop

7. Claude Desktop MCP Terminal

API

execute_command

• `command` (string)

• `wait_for_output` (boolean, ) true

• `timeout` (integer, ) 10

• `success` (boolean)

• `output` (string, )

• `error` (string, )

• `return_code` (integer, )

• `warning` (string, )

get_terminal_info

• `terminal_type` (string)

• `platform` (string)

1. Fork

2. (`git checkout -b feature/amazing-feature`)

3. (`git commit -m 'Add some amazing feature'`)

4. (`git push origin feature/amazing-feature`)

5. Pull Request