fix(docker): production deployment fixes, MCP server, and documentation

[mabry1985]

Summary

• Fix Docker production build issues (missing dependencies, nginx proxy config)
• Add MCP server for programmatic board interaction
• Add comprehensive deployment documentation
• Add batch scripting support for feature creation

Changes

Docker Fixes

• Add missing zod dependency to apps/ui
• Add missing fast-xml-parser dependency to libs/spec-parser
• Add libs/spec-parser/package.json to Dockerfile COPY commands
• Change VITE_SERVER_URL default to empty string for nginx proxy
• Add nginx proxy config for /api routes to server container
• Add GH_TOKEN environment variable support to docker-compose.yml

MCP Server (packages/mcp-server)

New MCP server with 22 tools for Claude Code integration:

• Feature management (list, create, update, delete, move)
• Agent control (start, stop, list, send messages)
• Queue management (add, list, clear)
• Context files (list, get, create, delete)
• Project spec (get, update)
• Utilities (health check, board summary)

Documentation

• HANDOFF.md - Production deployment guide with:
  • Docker setup instructions
  • Authentication methods (Claude OAuth, API keys, GH_TOKEN)
  • Proxmox VM specifications (minimum/baseline/heavy use)
  • Troubleshooting guide
• README.md - Fixed API key instructions for development

Scripts

• scripts/batch-create-features.sh - Batch create features via API
• scripts/example-features.json - Example feature format

Test plan

• Docker build completes successfully
• UI connects to server through nginx proxy
• Local dev mode works with fixed API key
• MCP server builds and runs
• Test MCP tools with Claude Code

🤖 Generated with Claude Code

Summary by CodeRabbit

• New Features

  • Introduced Automaker MCP Server package enabling external integrations with feature management, agent control, queue management, context files, and project specification tools.

• Documentation

  • Added comprehensive setup and configuration guide for the new MCP Server package, including installation and usage examples.

[coderabbitai]

Caution

Review failed

The pull request is closed.

Walkthrough

A new MCP (Model Context Protocol) server package is introduced that exposes Automaker's board and feature management capabilities over a stdio-based protocol. The package includes server implementation with API gateway, tool catalog, tool dispatcher, TypeScript configuration, and comprehensive documentation.

Changes

Cohort / File(s)	Summary
Package Configuration package.json, tsconfig.json	New package manifest for @automaker/mcp-server with build/dev scripts and TypeScript configuration targeting ES2022 with strict mode enabled.
Server Implementation src/index.ts	Complete MCP server with API gateway (apiCall), comprehensive tool catalog (feature/agent/queue/context/spec management), centralized tool dispatcher (handleTool), stdio-based transport, and error handling for API interactions.
Documentation README.md	Comprehensive guide covering installation, configuration for Claude Code and environment variables, tool catalog reference, usage examples, and development commands.

Sequence Diagram(s)

sequenceDiagram
    participant Client as Client/Claude
    participant Server as MCP Server
    participant Dispatcher as Tool Dispatcher
    participant Gateway as API Gateway
    participant API as Automaker API
    
    Client->>Server: Request tool (e.g., list features)
    Server->>Dispatcher: handleTool(toolName, input)
    Dispatcher->>Gateway: apiCall(endpoint, method, payload)
    Gateway->>API: HTTP request
    API-->>Gateway: Response
    Gateway-->>Dispatcher: Parsed result
    Dispatcher-->>Server: Formatted response
    Server-->>Client: MCP tool result (JSON)

Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch fix/docker-production-setup

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}