BugPack

AI-powered bug tracking and fixing toolkit. List, view, and fix bugs from BugPack.

Prerequisites

Start BugPack server first:

npx bugpack-mcp

Skill 1: List Bugs

Query all tracked bugs with optional filtering.

Instructions

1. Call GET http://localhost:3456/api/bugs to fetch all bugs.
   • Optional: ?project_id=<id> to filter by project.
2. Each bug has: id, title, description, status, priority, project_id, created_at.
3. Present results grouped by status (pending / fixed / closed).

Example

GET http://localhost:3456/api/bugs

Skill 2: View Bug Details

Fetch full bug context including screenshots, environment, and related files.

Instructions

1. Call GET http://localhost:3456/api/bugs/:id for full details.
2. Response includes: title, description, status, priority, pagePath, device, browser, relatedFiles, screenshots.
3. Use relatedFiles to locate relevant source code.
4. Screenshots have original_path and annotated_path.

Example

GET http://localhost:3456/api/bugs/abc-123

Skill 3: Fix Bug

Read bug context, locate code, apply fix, and update status.

Instructions

1. Get context: GET http://localhost:3456/api/bugs/:id
2. Analyze: Read description and examine screenshots.
3. Locate code: Use relatedFiles or search by pagePath and description.
4. Apply fix: Edit source code following project conventions.
5. Mark fixed: PATCH http://localhost:3456/api/bugs/:id with { "status": "fixed" }
6. Add note (optional): Update description to document what was changed.

Example

# Get bug context
GET http://localhost:3456/api/bugs/abc-123

# Mark as fixed
PATCH http://localhost:3456/api/bugs/abc-123
Content-Type: application/json

{ "status": "fixed" }