🤖 v0.21.1 — MCP Docs & Installer Flags

What's New

MCP Server documentation

A full documentation page now ships with the demo app covering MCP server setup, tool reference, and integration guides. Includes configuration examples for Claude Code, Cursor, VS Code (Copilot), and Windsurf, plus detailed request/response examples for all four MCP tools (list_components, get_component_api, search_components, get_component_examples).

AGENTS.md guide

A new top-level agent guide for AI coding assistants. Documents test runners, linting, architecture, naming conventions, and contribution patterns so that Claude Code, Cursor, and similar tools can orient themselves in the repo without manual prompting.

Agent context generation

A new bin/generate-agent-context script regenerates the Midwest skill file (lib/install/claude/midwest.md) from the current component source. The skill file now includes live MCP server connection instructions so agents can self-configure.

What Changed

midwest:install — selective step flags

The install task now accepts --flag arguments to run individual setup steps instead of the full installer. Available flags: --layout, --js, --helpers, --stimulus, --claude, --mcp.

bundle exec rails midwest:install --mcp        # Only configure the MCP server
bundle exec rails midwest:install --claude      # Only install the Claude skill file
bundle exec rails midwest:install --mcp --claude # Both

The underlying install.rb template was refactored from top-level constants to gated run_step? blocks, and extracted a shared install_package helper.

What Was Removed

Nothing removed.

Dev Process

Installer test suite

A new test/install/install_test.rb covering the refactored installer — step filtering via MIDWEST_INSTALL_STEPS, layout injection (ERB and HAML), importmap and npm/yarn paths, Stimulus registration, Claude skill copy, and MCP config generation.

MCP server test suite

A new test/lib/midwest/mcp/server_test.rb with comprehensive coverage of the MCP server's stdio transport, tool dispatch, component parsing, and search indexing.

Release script update

Minor improvements to bin/release for the new version workflow.