mcp server for unix pty control

terminal-mcp

Unix PTY 制御用のネイティブMCP サーバーです。

概要

AI モデルに実際のターミナルへのアクセスを提供する MCP サーバーです。セッションを起動し、コマンドを実行し、出力を読み取ります。それだけです。

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "create_session",
    "arguments": {
      "session_name": "prod-debug",
      "command": "ssh prod.server"
    }
  }
}

主な機能

• 真の PTY：AppleScript の小細工ではなく、本物の Unix ターミナルです
• すべて非同期：Tokio によるノンブロッキング I/O
• スマートバッファリング：新しい出力のみを取得し、重複はありません
• セッションの永続化：呼び出しの合間もターミナルが動作し続けます
• マルチセッション対応：複数のターミナルを同時に実行し、切り替えられます

概念

• セッション：名前付きのターミナルインスタンス（bash、python、ssh）
• ツール：AI が呼び出す MCP プロトコルのエンドポイント
• PTY：適切なシェル操作を実現する疑似ターミナル
• マネージャー：ライフサイクル管理とクリーンアップの自動化

ツール

• create_session：新しいターミナルを起動します
• execute_command：コマンドを実行し、すぐに出力を取得します
• execute_command_async：長時間実行されるコマンドを開始します
• read_streaming_output：非同期コマンドの進行状況を確認します
• list_sessions：実行中のセッションを確認します
• destroy_session：不要になったセッションをクリーンアップします
• send_control_character：Ctrl-C などを送信します

設定

Claude Code：

cargo install --git https://github.com/ianks/terminal-mcp
claude mcp add --scope user terminal-mcp

開発

cargo test -- --nocapture           # see test output
RUST_LOG=debug cargo run            # verbose logging
cargo clippy                        # lint
cargo fmt                           # format

アーキテクチャ

mcp api layer (json-rpc)
    ↓
session manager (lifecycle)
    ↓
pty engine (pty-process)
    ↓
unix ptys (kernel)

哲学

AI は人間と同じようにコンピューターを操作できます。 抽象化はありません。シェルだけです。

ライセンス

MIT