Iterm Terminal

🚀 iterm-mcp

iTermセッションへのアクセスを提供するモデルコンテキストプロトコル（Model Context Protocol）サーバーです。このサーバーを使用することで、iTermとモデルを連携させ、様々な操作を行うことができます。

✨ 主な機能

効率的なトークン使用：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.jsバージョン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を通じたインストール

Claude DesktopにiTermプラグインを自動的にインストールします。

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

🔧 開発

依存関係のインストール

yarn install

サーバーのビルド

yarn run build

自動再構築を伴う開発

yarn run watch

デバッグ

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

yarn run inspector
yarn debug <command>

InspectorはデバッグツールにアクセスするためのブラウザURLを提供します。