sandbox-mcp-server
A scaffolded MCP server implemented with FastAPI, Celery, Terraform, and Helm to orchestrate build, deploy, and infrastructure workflows.
Getting started
- Create a virtual environment and install dependencies:
bash python -m venv .venv source .venv/bin/activate pip install -r requirements-dev.txt - Launch dependencies locally with Docker Compose:
bash docker-compose up --build - Run the API locally:
bash 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.
