envy-mcp-hello

Envyが管理するModalサンドボックスを利用した小さな公開MCPサーバーです。1つのhello環境と標準的なEnvy MCPツールを公開しています：

create_sandbox · kill_sandbox · bash · read · write · edit · glob · grep

この例では、現在のFastMCP 4のプレリリース（4.0.0b3）を固定しているため、公開デプロイメントはv4サーバーとクライアントプロトコルをテストします。

デプロイする

1. modal-labsワークスペースでModalトークンを作成します。

2. このGitHubリポジトリで、Settings → Secrets and variables → Actions の下に以下のActionsシークレットを追加します：

   • MODAL_TOKEN_ID

   • MODAL_TOKEN_SECRET

3. mainにプッシュするか、Actionsタブから手動でDeploy MCP serverを実行します。

ワークフローは公開リポジトリaaazzam/envyからEnvyをインストールし、宣言テストを実行して、devboxes.py内のmodal_appをModalにデプロイします。

デプロイされたMCP URLは次のとおりです：

https://modal-labs-aaazzam-dev--envy-mcp-hello-serve.modal.run/mcp

エンドポイントは実験のために意図的に公開されています。helloサンドボックスにシークレットやプライベートなソースコードを入れないでください。

Related MCP server: Modal MCP

試してみる

MCPクライアントをURLに向けて、以下を呼び出します：

1. create_sandbox を environment: "hello" で呼び出す

2. write /tmp/hello/message.txt を hello from MCP で呼び出す

3. そのファイルに対して read、edit、bash、glob、または grep を呼び出す

4. read /tmp/hello/README.md を呼び出すか、/tmp/hello/hello.py を実行する

5. 終了したら kill_sandbox を呼び出す

サンドボックスは一時的で、ワーキングディレクトリとして /tmp/hello を使用し、小さな README.md と hello.py のHello Worldフィクスチャで初期化されています。

ローカル検証

PythonとMCP拡張がインストールされている状態で：

python -m unittest discover -s tests

ライブのModal統合は意図的にGitHub Actionの一部ではありません。Actionは公開コントロールプレーンをデプロイし、サンドボックスの作成はMCPクライアントがcreate_sandboxを呼び出したときに行われます。