react-uswds-mcp

An MCP server that indexes your locally-installed @trussworks/react-uswds package (from the host project's node_modules) and exposes tools/resources that help code assistants:

• discover components

• inspect detected Props surfaces (best-effort)

• generate correct import + usage snippets

• suggest components for a UI use case

Prerequisites

• Node.js 18+

• Yarn (recommended Yarn 4.12)

Install

Build + run

Dev (no build)

Environment

• REACT_USWDS_PACKAGE (optional): package name to resolve. Default is @trussworks/react-uswds.

MCP host configuration (example)

Tools

• list_components

• search_components

• get_component

• get_component_usage

• suggest_components

Resources

• resource://react-uswds/index

• resource://react-uswds/components/{name}