envy-mcp-hello

Envy가 관리하는 Modal 샌드박스로 구동되는 소형 공개 MCP 서버입니다.
하나의 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. environment: "hello"와 함께 create_sandbox 호출

2. write로 /tmp/hello/message.txt에 hello from MCP 작성

3. 해당 파일에 대해 read, edit, bash, glob 또는 grep 사용

4. /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를 호출할 때 발생합니다.