mcp-micromanage-your-agent

mcp-micromanage is an MCP server that helps you control and coordinate a coding agent by enforcing a plan-first workflow. It provides tools to define implementation plans as PRs and commits, track progress across work items, and require user feedback at key checkpoints to keep the agent aligned with your ticket requirements. A core feature is a visualization dashboard (React-based) that gives a real-time, hierarchical view of PRs and commits, with status-based color coding and zoom/pan navigation, allowing you to monitor both the plan and the execution status in one place. The server can be run headlessly via MCP tooling or with the visualization frontend for an interactive experience.

To use it, add the micromanage server to your MCP configuration (as shown in the Getting Started section). The headless mode uses the MCP tool to invoke the package with npx, while the visualization mode lets you run a local frontend that connects to the backend to display progress and plan status. The available operations you’ll leverage are defining your plan with plan, tracking progress with track, and updating status with update, all constrained by mandatory user reviews at commit-level checkpoints.

Prerequisites:

• Node.js (recommended LTS, v14+)
• npm or pnpm

Installation steps:

1. Ensure Node.js and npm are installed

   • node -v
   • npm -v

2. Install or run via npx (no local install needed)

   • Headless mode (recommended for MCP integration): npx -y @yodakeisuke/mcp-micromanage

3. If you prefer a local install for repeated usage:

   • npm install -g @yodakeisuke/mcp-micromanage
   • mcp-micromanage

4. Optional: Set up visualization frontend (per README):

   • git clone https://github.com/yodakeisuke/mcp-micromanage-your-agent.git
   • cd mcp-micromanage-your-agent
   • npm install
   • npm run build
   • cd visualization/
   • npm install
   • npm run dev

Prereqs recap:

• A working MCP-enabled project where you can add the micromanage server to your mcp.json
• Access to the internet to install npm packages (for npx or local install)

Tips and considerations:

• The MCP server is published as an npm package @yodakeisuke/mcp-micromanage. Use npx for quick execution or install locally for repeated runs.
• If you enable the visualization dashboard, ensure the frontend build is compatible with your backend version and that CORS/configs allow the frontend to fetch data.
• You can adjust the mcp.json configuration to alias the server as micromanage to match your project naming conventions.
• Environment variables: no required env vars are documented in the README; you may add placeholders if needed (e.g., for API endpoints or auth tokens) under the env field in mcp_config.
• Common issues may include network problems when fetching the package via npx, or build failures if dependencies aren’t installed for the visualization frontend. Ensure Node.js version compatibility and run npm install where indicated.