ui-ticket-mcp 0.1.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.

Install

pip install ui-ticket-mcp

MCP Server (for AI agents)

Add to your .mcp.json:

{
  "mcpServers": {
    "review-system": {
      "command": "python",
      "args": ["-m", "review_mcp.mcp_server"],
      "env": {
        "PROJECT_ROOT": "/path/to/your/project"
      }
    }
  }
}

Reviews are stored in {PROJECT_ROOT}/.reviews/reviews.db (auto-created, committable to git).

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

REST API (for browser UI)

PROJECT_ROOT=/path/to/your/project python -m review_mcp.api
# → http://localhost:3200

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