ui-ticket-mcp 0.4.0

Review system MCP server for UI prototypes. Humans write comments in browser, AI agents resolve them via MCP.

ui-ticket-mcp

Review system for UI prototypes. Humans write comments in the browser, AI agents resolve them via MCP. One server serves both.

Setup

Start the server:

PROJECT_ROOT=/path/to/your/project uvx ui-ticket-mcp
# → http://localhost:3200 (/mcp + /api)

Add to your .mcp.json:

{
  "mcpServers": {
    "review-system": {
      "type": "http",
      "url": "http://localhost:3200/mcp"
    }
  }
}

Reviews are stored in {PROJECT_ROOT}/.reviews/reviews.db (auto-created, committable to git). Port configurable via REVIEW_PORT env var.

Fallback if you don't have uv: pip install ui-ticket-mcp, then run ui-ticket-mcp.

MCP Tools

Tool	Description
get_review_summary()	Summary of pages with open/resolved counts
get_reviews(page_id?)	List comments, optionally filtered by page
add_review(page_id, author, text)	Add a new comment
resolve_review(review_id, resolved_by?)	Mark as resolved
reopen_review(review_id)	Reopen a resolved review
batch_resolve(page_id, resolved_by?)	Resolve all open on a page
get_pending_work()	Open reviews grouped by page (todo list)
find_source_file_tool(page_id)	Find source files matching a page_id
get_setup_guide()	Full setup guide for the review system

REST API (for browser UI)

Method	Endpoint	Description
GET	/api/reviews/summary	Per-page summary
GET	/api/reviews	All reviews
GET	/api/reviews/{page_id}	Reviews for a page
POST	/api/reviews/{page_id}	Add review
PATCH	/api/review/{id}	Update status/text
DELETE	/api/review/{id}	Delete review

More

Full documentation: github.com/0ics-srls/ui-ticket-mcp