Menager MCP Server

menager は、セッション間のターミナルオーケストレーション用に設計された TypeScript ベースの Model Context Protocol (MCP) サーバーです。AI エージェントセッション(または人間のオペレーター)がマスターコントロールプレーンとして機能し、標準の POSIX 疑似端末(pty)を介して子ターミナルハーネス(CLI ツール、セカンダリ AI エージェント、対話型シェル、または多言語ランタイム)を起動、監視、駆動、フックできるようにします。

目次

• 機能

• インストール

• 使用方法

  • サーバーの起動

• 利用可能なツール

  • session_spawn

  • session_write

  • session_read

  • session_hook

  • session_signal

  • session_list

Related MCP server: pty-mcp

機能

• 多言語ハーネスの多重化: 標準の POSIX 疑似端末を介して、任意の言語で書かれた対話型プロセスを駆動します。

• 人間のタイピングのシミュレーション: テキスト、制御シーケンス(SIGINT、EOF、Ctrl+C)、および生のキーストロークを子 stdin にシームレスに注入します。

• 予測可能なイベント傍受: タイムアウト保証付きのノンブロッキングな正規表現フックと、オプションの即時自動応答を提供します。

• メモリ制限付き可観測性: セッションごとに専用の循環バッファ(デフォルト 5,000 行)を維持し、トークン効率の高い LLM コンテキスト消費のためにリアルタイムで ANSI コードを除去します。

• 厳格な非同期性とリソース規律: イベント処理は Node.js の event emitter と promise を使用した純粋なイベント駆動方式を維持し、メモリリークを防ぐためにバッファ上限を厳密に適用します。

インストール

手動インストール

# Clone the repository
git clone <your-repo-url>
cd menager

# Install dependencies (requires build-essential/g++ for node-pty native bindings)
npm install

# Build the project
npm run build

使用方法

サーバーの起動

サーバーは Stdio トランスポート経由で実行され、MCP クライアントによって直接実行されることを意図しています。

# Start the server (standard mode)
npm start

# Or run the built file directly
node build/index.js

利用可能なツール

session_spawn

新しい子 PTY セッションを起動します。

• command (string): 対象のバイナリまたは実行可能ファイル(例: bash、python3)。必須。

• args (string[]): コマンドライン引数。

• cwd (string): 作業ディレクトリのパス。

• env (object): 追加の環境変数。

• maxBufferLines (number): メモリバッファのローリング行数制限(デフォルト 5000)。

• terminalType (string): ターミナルエミュレーションの種類("dumb" または "xterm-256color"、デフォルト "xterm-256color")。

• name (string): セッションのオプションの論理名/ラベル。

• cols (number): ターミナルの列数(デフォルト 80)。

• rows (number): ターミナルの行数(デフォルト 24)。

session_wait

セッションが正常に終了するまでブロックして待機し、最終的な終了コードを返します。

• sessionId (string): 対象セッション ID。必須。

• timeoutMs (number): オプションのタイムアウト(ミリ秒)。

session_write

キーストローク、コマンド、またはエスケープシーケンスをセッションの標準入力に注入します。

• sessionId (string): 対象セッション ID。必須。

• payload (string): 文字列または制御文字シーケンス。必須。

• pressEnter (boolean): ペイロードに \n を追加します(デフォルト false - v4 での破壊的変更)。

• pressKey (string): 特別なキー注入(Ctrl+C、Ctrl+D、Enter、Tab、Escape、ArrowUp、ArrowDown)。

session_read

対象セッションからバッファリングされた出力を読み取ります。

• sessionId (string): 対象セッション ID。必須。

• tailLines (number): 取得する末尾の行数(デフォルト 100)。

• stripAnsi (boolean): ANSI コードを含まないサニタイズされたテキストを返します(デフォルト true)。

• clearBuffer (boolean): 読み取り後に内部バッファをフラッシュします(デフォルト false)。

• offsetLines (number): この絶対インデックスオフセットから行を読み取ります(tailLines を置き換えます)。

• grepPattern (string): 正規表現文字列のマッチングでバッファ行を事前フィルタリングします。

session_hook

セッションストリーム上の特定の正規表現パターンを、オプションの自動応答付きで待機します。

• sessionId (string): 対象セッション ID。必須。

• pattern (string): 監視する正規表現文字列。必須。

• timeoutMs (number): タイムアウトまでのミリ秒(デフォルト 30000)。

• autoResponse (string): マッチ時に即座に書き込むオプションの文字列。

• triggerPayload (string): フック登録後にペイロードを書き込みます(並行性デッドロックを防止)。

session_resize

対象 PTY ターミナルの寸法を変更します。

• sessionId (string): 対象セッション ID。必須。

• cols (number): ターミナルの列数。必須。

• rows (number): ターミナルの行数。必須。

session_signal

対象セッションに POSIX シグナルを送信します(プロセスの再帰的なツリー終了付き)。

• sessionId (string): 対象セッション ID。必須。

• signal (string): 送信するシグナル(SIGINT、SIGTERM、SIGKILL)。必須。

session_close

セッションのプロセスツリーを強制終了し、メモリバッファを直ちに削除します。

• sessionId (string): 対象セッション ID。必須。

session_prune

メモリを解放するためにセッションを強制削除します。

• status (string): このステータスを持つセッションのみ削除します("running" または "exited")。デフォルトは "exited"。

session_info

単一セッションのライブメタデータとメトリクスを返します。

• sessionId (string): 対象セッション ID。必須。

session_list

サーバーが管理するすべてのアクティブおよび完了済みセッションを一覧表示します。パラメータは不要です。

AI アシスタントでの設定

Roo Code または Cline での設定

1. MCP 設定ファイル(通常は cline_mcp_settings.json または config.json)を開きます。

2. 標準の stdio モード用に次の設定を追加します:

{
  "mcpServers": {
    "menager-mcp": {
      "command": "node",
      "args": ["/path/to/menager/build/index.js"],
      "env": {}
    }
  }
}

Claude Desktop での設定

1. claude_desktop_config.json を開きます。

2. 次の設定を追加します:

{
  "mcpServers": {
    "menager-mcp": {
      "command": "node",
      "args": ["/path/to/menager/build/index.js"],
      "env": {}
    }
  }
}