react-analyzer-mcp

Local Docker-managed MCP server for analyzing React code and generating component docs from a mounted workspace.

This is based on the upstream azer/react-analyzer-mcp, adapted for Docker MCP Toolkit:

• no hardcoded project root
• mounted workspace root via Docker MCP config
• safer path handling for project analysis
• local image and catalog entry like your other custom MCP servers

Tools

• analyze-react
  • analyze a JSX or TSX source string directly
• analyze-project
  • scan a mounted project path and generate markdown docs for components
• list-projects
  • list top-level directories under the mounted workspace root
• react-analyzer__server-status
  • show the effective workspace root and whether it is accessible

Build

docker build -t react-analyzer-mcp:latest .

Local Node Build

npm install
npm run build

Direct Docker Run

docker run -i --rm \
  -e REACT_ANALYZER_MCP_WORKSPACE_ROOT=/workspace \
  -v /Users/mwdghaz:/workspace:rw \
  react-analyzer-mcp:latest

Cross-Platform Notes

• set workspace_root to your real host project root
• inside the container, the mounted root is always /workspace
• examples:
  • macOS: /Users/name/project
  • Linux: /home/name/project
  • Windows: C:\\Users\\name\\project

Docker MCP

Import the local catalog:

docker mcp catalog import /Users/mwdghaz/mcp-workspace/react-analyzer-mcp/catalog.yaml

Then configure and enable the server in Docker MCP Toolkit.

The local config template is config.yaml.

Codex / Docker Gateway

This repo can be exposed through the Docker MCP gateway with:

docker mcp gateway run \
  --additional-catalog /Users/mwdghaz/mcp-workspace/react-analyzer-mcp/catalog.yaml \
  --additional-config /Users/mwdghaz/mcp-workspace/react-analyzer-mcp/config.yaml

Notes

• analyze-project scans .jsx and .tsx files recursively.
• common heavy folders like node_modules, dist, build, .next, and .git are skipped.
• paths outside the mounted workspace root are blocked.