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.