Iterm MCP

🚀 iterm-mcp

iterm-mcpは、iTermセッションへのアクセスを提供するモデルコンテキストプロトコル（Model Context Protocol）サーバーです。このサーバーにより、モデルがiTermの出力を効率的に利用でき、自然にiTermと統合してタスクを実行することが可能になります。

✨ 主な機能

• 効率的なトークン使用: iterm-mcpを使用すると、モデルは関心のある出力のみを参照できます。通常、モデルは長時間実行されるコマンドでも、実行結果の最後の数行の出力のみを必要とします。
• 自然な統合: モデルとiTermを共有できます。画面上に表示されている内容を尋ねたり、タスクをモデルに委託し、モデルが各ステップを実行する様子を見ることができます。
• 完全なターミナル制御とREPLサポート: モデルはREPL（例えばPythonの対話型インタープリター）を起動して対話的に使用することができ、制御文字（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",