Stackconstruct MCP Server

stackconstruct

AWS CDK guidance as MCP tools. stackconstruct is a clean-room rebuild of the core surface of the AWS CDK MCP server, under a new name: fresh curated guidance content and fresh code, no copied branding and no copied documentation text.

Tools (core subset, 10)

get_cdk_best_practices, search_cdk_docs, get_cdk_concept, list_cdk_patterns, search_constructs, get_construct_details, validate_stack_nag, get_migration_guide, explain_error, get_example_pattern.

Keyless-first: the guidance tools (best practices, concepts, patterns, migration guides, error explanations) are local deterministic content written for this rebuild, and validate_stack_nag runs local checks over a stack-template JSON you supply — wildcard IAM actions/resources, unencrypted S3 buckets and EBS volumes, buckets without a full public-access block, and security groups open to the world. Only search_cdk_docs, search_constructs and get_construct_details fetch, from the public AWS documentation site and the constructs.dev public API.

Not in this subset: project bootstrap and initialisation, stack deployment or synthesis execution, CDK Pipelines management, context and feature-flag administration, construct code generation, and anything that mutates an AWS account or a local project.

Setup

No credentials are required. Optionally override the lookup bases:

export CDK_DOCS_URL=https://docs.aws.amazon.com        # default
export CONSTRUCTS_API_URL=https://constructs.dev       # default

CLI

npx @reneturcios/stackconstruct get_cdk_best_practices '{"topic":"security"}'
npx @reneturcios/stackconstruct validate_stack_nag '{"template":{"Resources":{}}}'
npx @reneturcios/stackconstruct mcp        # stdio MCP server

Each tool name is a subcommand taking one JSON object argument.

MCP client config

{
  "mcpServers": {
    "stackconstruct": {
      "command": "npx",
      "args": ["-y", "@reneturcios/stackconstruct", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/stackconstruct

Development

npm install
npm run build
npm test

License

MIT