@brycepelletier/agent-env-mcp

堅牢化されたLinuxソフトウェアエンジニアリングランタイム向けの、再利用可能なホスト側MCPコントローラ。

0.3.1 トラスト分割

Composeランタイムは、同一の作業ツリー上に2つの実行ドメインを持ちます:

• agent: Software Engineerツールが使用します。実際の.gitディレクトリは、root所有のtmpfsマウントでマスクされます。

• git: git_commandのみが使用します。実際の.gitディレクトリを参照し、network_mode: noneを持ちます。

リモートのGit/GitHub操作はこのパッケージには属しません。これらは別のGitHub MCPトラストドメインを対象としています。

Related MCP server: anvil

ツール

• ensure_environment

• list_directory

• read_file

• search_workspace

• workspace_edit

• run_command

• git_command

MCPは、ツールが最初に使用されたときに、MCP Rootsを通じてアクティブなVS Codeワークスペースを遅延的に検出します。起動時の${workspaceFolder}変数は必要ありません。

ローカル開発

npm run link

リンク中のユーザーレベルのVS Code MCP設定:

"agent-env": {
  "type": "stdio",
  "command": "agent-env-mcp"
}

グローバル開発リンクを削除するには:

npm run unlink

0.3.1 受け入れチェック

プロジェクトの古い.devcontainerを削除する前に:

1. ensure_environmentが成功し、/agent-env/environment/<project>を報告すること。

2. run_commandがプロジェクトをビルドできること。

3. run_commandが、Python/Node経由で間接的にGitを呼び出した場合でも、実際のGitブランチ/履歴を取得できないこと。

4. git_command ["status", "--short", "--branch"]が成功すること。

5. Gitサービスがネットワークアクセスを持たないこと。

現在の.gitマスキング実装は、.gitがディレクトリである標準チェックアウトを前提としています。.gitファイルを使用するGitワークツリー/サブモジュールは、そのリポジトリ形式に対してこのランタイムを堅牢化済みとして扱う前に、拒否するか、将来のマウント戦略で処理する必要があります。