terraform-setup

Deploy MCP Gateway & Registry to AWS using the Terraform aws-ecs stack.

892|225|Updated May 29, 2025
One-click install
npx skills add https://github.com/agentic-community/mcp-gateway-registry --skill terraform-setup
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: terraform-setup
Source: https://github.com/agentic-community/mcp-gateway-registry/tree/main/.claude/skills/terraform-setup
Command: npx skills add https://github.com/agentic-community/mcp-gateway-registry --skill terraform-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deploying the MCP Gateway & Registry on AWS involves many moving parts — IAM permissions, toolchain setup, Terraform variables, and post-deployment configuration — and a single misstep (wrong region, missing password, unset image URI) causes cryptic failures. This Skill turns that into a guided, step-by-step deployment with validation at every phase.

Core Features & Use Cases

  • Guided environment setup: Detects whether you run from EC2 or a local laptop, verifies AWS credentials and required IAM permissions, and bootstraps the toolchain (uv, AWS CLI, Terraform).
  • Validated Terraform configuration: Configures terraform.tfvars for CloudFront-only mode, checks DocumentDB region support, collects required secrets, and prevents known failure modes like empty registry names or missing observability images.
  • End-to-end deployment: Runs terraform apply with cost and duration warnings, then completes post-deployment setup including registering the AWS KB MCP server.
  • Use Case: A platform engineer wants a governed MCP registry running on ECS Fargate with Aurora and DocumentDB. Invoke the skill, answer a few questions, and get a working HTTPS deployment in about 30 minutes.

Quick Start

Ask the AI to deploy the MCP Gateway & Registry to AWS using Terraform in CloudFront mode and follow the guided prompts.

Frequently Asked Questions about terraform-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy MCP Gateway & Registry on AWS with Terraform?▼

Invoke the terraform-setup skill, which guides you through environment selection, IAM permission verification, repository cloning, terraform.tfvars configuration, and terraform apply. The deployment uses the aws-ecs stack with ECS Fargate and typically takes 20-30 minutes.

What AWS permissions are required for the Terraform ECS deployment?▼

The deploying identity needs broad permissions including ec2, ecs, rds, docdb, s3, iam, cloudfront, secretsmanager, and others listed in the skill's IAM policy. The skill does not create these roles; it tells you what is needed and can guide you through setup.

Does the deployment require building Docker images?▼

No. The core services (registry, auth-server, mcpgw) pull pre-built images from public ECR. Docker is only needed if you enable the observability pipeline (Grafana and metrics-service images) or want to deploy custom builds.

Why does terraform apply fail with DocumentDB or registry errors?▼

Common causes include deploying to a region without DocumentDB support, leaving documentdb_admin_password empty, or leaving registry_name empty which crash-loops the registry container. The skill validates all of these before applying.

Can I use a custom domain instead of the CloudFront URL?▼

Yes, but this skill deploys in CloudFront-only mode by default. To use a custom domain, set enable_route53_dns to true, configure base_domain and session_cookie_domain in terraform.tfvars, and create a Route53 hosted zone.

How much does the MCP Gateway AWS infrastructure cost?▼

The stack costs roughly $170-330 per month in us-east-1, dominated by Aurora, DocumentDB, ECS, and two Application Load Balancers. Running terraform destroy with the pre-destroy cleanup tears everything down.