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)

Related MCP server: react-design-systems-mcp

Install

yarn install

Build + run

yarn build
yarn start

Dev (no build)

yarn dev

Environment

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

MCP host configuration (example)

{
  "mcpServers": {
    "react-uswds-mcp": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/react-uswds-mcp/dist/index.js"],
      "env": {
        "REACT_USWDS_PACKAGE": "@trussworks/react-uswds"
      }
    }
  }
}

Tools

• list_components

• search_components

• get_component

• get_component_usage

• suggest_components

Resources

• resource://react-uswds/index

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