iTerm MCP Server

iterm-mcp

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 バージョン 18 以上

インストール

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

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

Smithery経由でインストール

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

発達

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

サーバーを構築します。

自動リビルドを使用した開発の場合:

デバッグ

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

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