sandbox-mcp-server

aelvion/sandbox-mcp-server

3.2

If you are the rightful owner of sandbox-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The sandbox-mcp-server is a specialized server designed to facilitate the implementation and testing of the Model Context Protocol (MCP) in a controlled environment.

sandbox-mcp-server

A scaffolded MCP server implemented with FastAPI, Celery, Terraform, and Helm to orchestrate build, deploy, and infrastructure workflows.

Getting started

  1. Create a virtual environment and install dependencies: 
    python -m venv .venv
source .venv/bin/activate
pip install -r requirements-dev.txt
  2. Launch dependencies locally with Docker Compose: 
    docker-compose up --build
  3. Run the API locally: 
    uvicorn mcp_server.app:app --reload

Make targets

  • make lint – Run ruff static analysis.
  • make test – Execute pytest.
  • make terraform-validate – Validate Terraform configuration without remote backend.
  • make terraform-plan – Run Terraform plan against the configured backend.

Infrastructure layout

  • infra/terraform – Terraform modules for VPC, EKS, IAM OIDC integration, Route53, and an environment wiring them together with an S3/DynamoDB backend.
  • infra/helm – Helm chart and ArgoCD Application manifest for deploying the MCP server.

Refer to docs/secrets.md for credential handling patterns and .env.example for environment variables.