@aws/nx-plugin is a collection of code generators that scaffold full-stack, production-ready AWS applications inside an Nx monorepo. Every generator produces best-practice application code and the infrastructure to deploy it — type-safe, locally runnable, and ready to deploy.

Quick Start

Build with AI

Add the MCP server to your AI assistant and let it build for you.

claude mcp add nx-plugin-for-aws -- npx -y @aws/nx-plugin-mcp

Install the Kiro Power for the best experience — no manual MCP configuration needed:

Open the Kiro Powers panel from the sidebar
Click + to add a custom power
Paste: https://github.com/awslabs/nx-plugin-for-aws/tree/main/powers/nx-plugin-for-aws
Click install

Or add the MCP server manually in .kiro/mcp.json:

{
  "mcpServers": {
    "nx-plugin-for-aws": {
      "command": "npx",
      "args": ["-y", "@aws/nx-plugin-mcp"]
    }
  }
}

claude mcp add nx-plugin-for-aws -- npx -y @aws/nx-plugin-mcp

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "nx-plugin-for-aws": {
      "command": "npx",
      "args": ["-y", "@aws/nx-plugin-mcp"]
    }
  }
}

Add to ~/.codex/config.toml:

[mcp_servers.nx-plugin-for-aws]
command = "npx"
args = ["-y", "@aws/nx-plugin-mcp"]

Most MCP-compatible assistants use a JSON configuration file. Add the following entry:

{
  "mcpServers": {
    "nx-plugin-for-aws": {
      "command": "npx",
      "args": ["-y", "@aws/nx-plugin-mcp"]
    }
  }
}

Then just ask:

"Use the Nx Plugin for AWS to build a full-stack app with a React website, a tRPC API, Cognito auth, and CDK infrastructure."

Your AI assistant will use the MCP tools to scaffold, connect, and configure everything. See the Building with AI guide for more details.

Build with the CLI

Create a workspace and start adding components — zero configuration required:

# Create a new workspace
pnpm create @aws/nx-workspace my-project
cd my-project

# Add a tRPC API
pnpm nx g @aws/nx-plugin:ts#api --framework=trpc

# Add a Strands AI agent (Python)
pnpm nx g @aws/nx-plugin:py#agent

# Add a React website
pnpm nx g @aws/nx-plugin:ts#website --framework=react

# Add authentication to your website
pnpm nx g @aws/nx-plugin:ts#website#auth

# Connect your website to your API and agent
pnpm nx g @aws/nx-plugin:connection

# Add CDK infrastructure to deploy it all (or choose Terraform)
pnpm nx g @aws/nx-plugin:ts#infra

See the full Quick Start guide and Dungeon Adventure tutorial for a deeper walkthrough.

Available Generators

Generator	Description
`ts#project`	TypeScript library
`ts#api`	TypeScript API (tRPC or Smithy) with API Gateway + Lambda + Powertools
`ts#rdb`	Relational databases with Aurora RDS
`ts#website`	React app (Vite)
`ts#website#auth`	Add Cognito auth to a website
`ts#infra`	AWS CDK infrastructure project
`ts#lambda-function`	TypeScript Lambda with type-safe event sources
`ts#mcp-server`	MCP server (TypeScript)
`ts#agent`	Strands Agent (TypeScript)
`ts#nx-generator`	Nx generator scaffold
`py#project`	Python project (uv)
`py#api`	Python API (FastAPI) with API Gateway + Lambda + Powertools
`py#lambda-function`	Python Lambda with type-safe event sources
`py#mcp-server`	MCP server (Python)
`py#agent`	Strands Agent (Python)
`connection`	Connect projects together (e.g. frontend to API)
`terraform#project`	Terraform project
`license`	Manage LICENSE files and source headers

Community

Join us on Slack in the #nx-plugin-for-aws channel to ask questions, share feedback, and connect with other users and contributors.

Contributing

Read our Contributing Guide to learn about our development process, how to propose bugfixes and improvements, and how to build and test your changes.

Code of Conduct

This project has adopted a Code of Conduct that we expect project participants to adhere to. Please read the Code of Conduct so that you can understand what actions will and will not be tolerated.

License

@aws/nx-plugin is Apache 2.0 licensed.

Nx Plugin For AWS

README