uvwt/agentdock

Secure MCP runtime for AI agents to operate local machines, servers, and containers with multi-device orchestration.

AgentDock MCP – 概要

AgentDockは、大規模言語モデル（LLM）チャットエージェント（ChatGPT、Claude、Grokなど）が、実際のコンピュータ、サーバー、コンテナ、またはブラウザ上で安全に動作できるようにするランタイムです。チャットUIを提供したり、モデル自体を実行したりすることはありません。その代わり、AIクライアントがファイル操作、シェルコマンドの実行、Gitの使用、ブラウザの自動化、「Skills」（プラグインツール）の呼び出しを行うために呼び出せるMCP (Multi-Client Protocol) HTTPエンドポイントを公開します。複数のAgentDockインスタンスをリンクさせることで、単一の会話から複数のマシンにまたがる作業を調整できます。

主な機能 (READMEより)

機能領域	AgentDockが提供するもの
ファイル・コマンドアクセス	UTF-8ファイルの読み込み/検索、安全なアトミック書き込み、ディレクトリトラバーサルの制限、タイムアウト付きコマンド実行、stdout/stderrの分離、PTYサポート、長時間実行セッション、出力の切り詰めと秘匿化。
Skillsと動的MCP	内蔵およびコミュニティ提供のSkills (`uvwt/agentdock-skills`経由)、ダイジェストベースのアトミック交換によるインストール/更新/削除、分離された環境変数、動的MCPサーバー登録、スキーマ検査。
ネイティブACP	OpenAI Codex、Anthropic Claude、Grokなどのためのオプションアダプター。ACPセッションの作成、プロンプトの実行、権限リクエストの処理、ホストのセキュリティ境界の遵守。
ブラウザ・デスクトップ自動化	ブラウザの起動/終了、ナビゲーション、クリック、入力、待機、ページテキスト/要素/ネットワークの検査、ログイン状態の永続化、スクリーンショット撮影。macOSデスクトップ自動化も含む。
復元可能なタスク	タスク状態の永続化、明確な目標/ステップ、チェックポイント、ブロッカー追跡、中断後の再開、最終的な証拠に基づくレビュー、再利用可能なワークフローテンプレート。
クロスデバイス調整	MCPを介した複数のAgentDockノード（ローカル、LANホスト、クラウドVPS）の接続。長期記憶、ランブック、共有ノート、アーティファクトプロキシのためのオプションのNexusDock統合。

標準的な使用フロー

各マシン（Docker、Linux、macOS、Windows、またはコンテナ）にAgentDockをインストールします。デフォルトのMCPエンドポイントは http://127.0.0.1:8765/mcp です。
認証を設定します。公開環境へのデプロイにはBearerトークンまたはOAuthが必要です。
LLMクライアントのツール設定（ChatGPTの「Tools」設定など）にMCP URLとトークンを追加します。
チャットから、LLMは以下のようなツール呼び出しを行います：
- read_file, write_file, run_command：ターゲットホストでのコード編集やテスト実行。
- git_pull, git_push：リポジトリ管理。
- browser.navigate や desktop.click：WebページやmacOSアプリとの対話。
AgentDockはホストのセキュリティサンドボックス内でリクエストを実行し、結果、ログ、および必要なフォローアッププロンプトを含む構造化されたJSONを返します。
複数のノードを同じ会話内で指定できるため、単一のAIが開発者のラップトップ、CIサーバー、本番VPSにまたがるワークフローを調整できます。

インストールと開始方法 (要約)

Docker – agentdockio/agentdock をプルして実行。ポートとトークンの設定についてはドキュメントを参照してください。
Linux – 自動化スクリプトまたは手動のsystemdサービス。
macOS / Windows – グラフィカルインストーラー。
インストール後、コントロールパネルまたはターミナルからMCP URLと認証トークンを取得し、AIクライアントに入力します。

想定されるユーザー

開発者：モデルに無制限のシェルアクセス権を与えることなく、LLMにコード編集、テスト実行、直接デプロイを行わせたい場合。
Ops / SREチーム：厳格な権限境界の下で、AIエージェントにサーバー、コンテナ、リバースプロキシを管理させたい場合。
プロダクトチーム：現実世界のアクション（ファイル編集、ブラウザ自動化）を安全に実行する必要がある、AI駆動のカスタムアシスタントを構築する場合。

プロジェクトの状況とコミュニティ

活発にメンテナンス中（CIバッジ、定期的なリリース、Dockerプル）。
Apache 2.0ライセンスでオープンソース化。
ドキュメントは uvwt.github.io/agentdock-docs でホスト。
QQグループによるコミュニティチャット。GitHub Issues/PRsを通じた貢献を歓迎。

結論

AgentDockは、LLMチャットエージェントと実際の機械を橋渡しする安全なランタイムです。ファイル操作、コマンド実行、Git、ブラウザ/デスクトップ自動化、および拡張可能な「Skills」のための明確に定義されたHTTPベースのプロトコルを公開しており、厳格なアクセス制御を維持しながら、単一のAI会話で複雑な複数マシン間のワークフローを調整できます。