iterm-mcp

iterm-mcp

iTerm セッションへのアクセスを提供する Model Context Protocol サーバーです。

特長

効率的なトークン使用： iterm-mcp を使うと、モデルは必要な出力だけを確認できます。長時間実行されるコマンドでも、モデルが通常確認したいのは最後の数行だけです。

自然な統合： iTerm をモデルと共有します。画面に表示されている内容について質問したり、タスクをモデルに任せて、各ステップの実行を見守ったりできます。

ターミナルの完全な制御と REPL のサポート： モデルは REPL を起動して操作できるほか、ctrl-c、ctrl-z などの制御文字も送信できます。

依存関係を最小限に： iterm-mcp は最小限の依存関係で構築されており、npx 経由で実行できます。Claude Desktop などの MCP クライアントに簡単に追加できるように設計されており、そのまま動作します。

安全に関する考慮事項

• ツールを安全に使用する責任はユーザーにあります。
• 組み込みの制限はありません。iterm-mcp は実行されるコマンドの安全性を評価しません。
• モデルは予期しない動作をすることがあります。ユーザーは動作を監視し、必要に応じて中断してください。
• 複数のステップからなるタスクでは、モデルが誤った方向に進んだ場合、中断が必要になることがあります。モデルの動作に慣れるまでは、小規模で範囲を絞ったタスクから始めてください。

ツール

• write_to_terminal - アクティブな iTerm ターミナルに書き込みます。コマンドの実行によく使用されます。コマンドが生成した出力行数を返します。
• read_terminal_output - アクティブな iTerm ターミナルから、指定した行数の出力を読み取ります。
• send_control_character - アクティブな iTerm ターミナルに制御文字を送信します。

要件

• iTerm2 が起動していること
• Node のバージョンが 18 以上であること

インストール

Claude Desktop で使用するには、サーバー設定を追加します。

macOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "iterm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "iterm-mcp"
      ]
    }
  }
}

Smithery 経由でのインストール

Smithery 経由で Claude Desktop 用の iTerm を自動的にインストールするには：

npx -y @smithery/cli install iterm-mcp --client claude

開発

依存関係をインストールします：

yarn install

サーバーをビルドします：

yarn run build

自動再ビルドを使って開発する場合：

yarn run watch

デバッグ

MCP サーバーは stdio 経由で通信するため、デバッグが難しい場合があります。パッケージスクリプトとして利用できる MCP Inspector の使用をおすすめします。

yarn run inspector
yarn debug <command>

Inspector により、ブラウザーでデバッグツールにアクセスするための URL が表示されます。