os-control-mcp

永続的なターミナルセッションのためのローカルMCP。プロセスはBash、CMD、PowerShell、pwsh、またはWSLをアクティブに保ち、入力の送信と出力の増分読み取りを分離します。

また、永続的な目標も備えています。エージェントは受け入れ基準を持つ目標を作成し、複数のステップを実行し、証拠を確認し、完了、失敗、ブロック、または定義された制限に達するまで継続できます。

注意: このサーバーは、実行するユーザーの権限でプロセスを制御します。ローカルで使用し、デフォルトでは管理者/rootとして実行せず、プロセスをインターネットに直接公開しないでください。

トランスポート

サーバーはstdio経由でMCP JSONLを使用します。デフォルトではネットワークポートを開きません。

Related MCP server: Persistent Terminal MCP Server

シェル

• POSIXシステムのbash、sh、zsh;

• Windowsのcmd、powershell、pwsh;

• Windowsのwsl-bash。OS_CONTROL_WSL_DISTROで定義されたディストリビューション、またはデフォルトのkali-linuxを使用します。

対話フロー

1. os_create_sessionが永続セッションを作成します。

2. os_send_inputがPTY/ConPTYに即座に書き込みます。

3. os_read_outputはsince_seqを使用して新しい出力のみを取得します。

4. os_session_statusはPID、シェル、ディレクトリ、終了を追跡します。

autonomous目標の外では、破壊的な可能性のあるコマンドには明示的な確認が必要です。自律目標では、目標で定義されたステップと時間の制限内で承認が継続されます。サーバーはローカル使用を目的としており、リモートトンネルの背後に配置する場合は、認証とスコープで保護し続ける必要があります。

自律目標

推奨フロー:

1. os_create_sessionが永続ターミナルを作成します。

2. os_goal_startが目標、基準、session_idを受け取ります。

3. os_send_inputはgoal_idを使用して、繰り返し確認なしで実行します。

4. os_read_outputは増分出力を読み取ります。

5. os_goal_updateはアクション、結果、証拠、次のステップを記録します。

6. エージェントはすべての基準を証明するまで繰り返します。

サーバーは次のアクションを発明したり、モデルを単独で呼び出したりしません。目標の状態と制限を維持します。クライアント/エージェントは、終了状態になるまで呼び出しを続ける必要があります。

インストール

git clone https://github.com/Willian-2-0-0-1/os-control-mcp.git
cd os-control-mcp
python -m pip install -r requirements.txt

Windowsでは、pywinptyがCMDとPowerShellのConPTYを有効にします。Kali/Linuxでは、バックエンドはネイティブPTYを使用します。.mcp.jsonファイルは、stdio経由でローカルサーバーを受け入れるMCPクライアントで使用できます。

GPT/Codex用プラグイン

リポジトリには、.codex-plugin/plugin.jsonマニフェストとMCPサーバーが含まれています。これにより、MCPプラグイン互換クライアントにパッケージを配布できます。

ChatGPTでローカルサーバーを使用するには、各ユーザーが自分のインスタンスを実行し、プライベート接続を構成する必要があります。GitHubリポジトリだけでは、ChatGPTにユーザーのコンピューターへのアクセス権は与えられません。