envy-mcp-hello

Un pequeño servidor MCP público respaldado por un sandbox de Modal gestionado por Envy. Expone un entorno hello y las herramientas MCP estándar de Envy:

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

Este ejemplo fija la versión preliminar actual de FastMCP 4 (4.0.0b3) para que el despliegue público ejercite el servidor y el protocolo de cliente v4.

Desplegarlo

1. Crea un token de Modal en el espacio de trabajo modal-labs.

2. En este repositorio de GitHub, añade estos secretos de Actions en Settings → Secrets and variables → Actions:

   • MODAL_TOKEN_ID

   • MODAL_TOKEN_SECRET

3. Haz push a main, o ejecuta Deploy MCP server manualmente desde la pestaña Actions.

El flujo de trabajo instala Envy desde el repositorio público aaazzam/envy, ejecuta la prueba de declaración y despliega modal_app en devboxes.py en Modal.

La URL MCP desplegada es:

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

El endpoint es intencionalmente público para experimentación. No pongas secretos ni código fuente privado en el sandbox hello.

Related MCP server: Modal MCP

Probarlo

Apunta un cliente MCP a la URL y llama:

1. create_sandbox con environment: "hello"

2. write /tmp/hello/message.txt con hello from MCP

3. read, edit, bash, glob o grep contra ese archivo

4. read /tmp/hello/README.md o ejecuta /tmp/hello/hello.py

5. kill_sandbox cuando termines

El sandbox es efímero, usa /tmp/hello como directorio de trabajo y está precargado con un pequeño README.md y hello.py como ejemplo de hello-world.

Validación local

Con Python y el extra MCP instalado:

python -m unittest discover -s tests

La integración en vivo con Modal no es intencionalmente parte de la GitHub Action. La Action despliega el plano de control público; la creación del sandbox ocurre cuando un cliente MCP llama a create_sandbox.