BugPack#

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

Prerequisites#

Start BugPack server first:

bash

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#

text

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#

text

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#

bash

# 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" }