AWS MCP Servers Guidance

Clone the guidance repository and install all workspace dependencies using pnpm. This sets up the monorepo with both the documentation site and infrastructure packages.

git clone https://github.com/aws-solutions-library-samples/guidance-for-vibe-coding-with-aws-mcp-servers.git
cd guidance-for-vibe-coding-with-aws-mcp-servers
npm install -g pnpm
pnpm install

Launch the Astro documentation site locally. It provides step-by-step workshop instructions at http://localhost:4321 that guide you through the full setup.

pnpm docs:init

Ensure your AWS CLI is configured with credentials that have permissions to deploy CloudFormation stacks, create Lambda functions, and access Amazon Location Service and Comprehend.

aws configure
# or use SSO:
aws sso login --profile your-profile

Follow the documentation at http://localhost:4321 to deploy the three CDK stacks: mock APIs, the booking agent, and the MCP server. The CDK deploy commands are provided in the workshop docs.

pnpm cdk deploy VibeCodingWorkshopMockApis
pnpm cdk deploy VibeCodingWorkshopBookingAgent
pnpm cdk deploy VibeCodingWorkshopMcpServer

Run the provided API test scripts to verify the hotel reservations and toxicity detection APIs are responding correctly after deployment.

pnpm test:apis:reservations
pnpm test:apis:toxicity

Configure Claude Desktop, Amazon Q Developer, or Kiro to point to the deployed MCP server endpoint. The exact MCP server URL is output by the CDK deploy step.

{
  "mcpServers": {
    "aws-workshop": {
      "command": "uvx",
      "args": ["<mcp-package-from-cdk-output>"],
      "env": {
        "AWS_REGION": "us-west-2"
      }
    }
  }
}