BugPack MCP server
Commit Oct 17, 2026Converts bug screenshots into structured, AI-ready fix instructions that coding agents can use to automatically locate and repair code issues.
Also known as duhuazhu/BugPack
- Stars
- 34
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Oct 17, 2026
- License
- MIT
What is BugPack MCP?
BugPack converts bug screenshots into structured, AI-ready fix instructions that coding agents can use to automatically locate and repair code issues.
Summary generated from the project's README
About BugPack MCP server
Converting bug screenshots into structured instructions for coding agents is what BugPack enables. This local-first tool allows developers and QA testers to paste screenshots, annotate issues using tools like arrows or rectangles, and generate Markdown instructions that AI agents can use to repair code. It eliminates the repetitive manual process of saving files and describing issues by compressing the workflow into roughly 30 seconds.
Users can run the server locally via npx and access a web interface at localhost:3456 to manage bugs. The built-in MCP server integrates with compatible tools such as Claude Code, Cursor, Windsurf, Cline, and VS Code. Once configured, an AI agent can use specific tools like list_bugs, get_bug_context, and mark_bug_status to identify, understand, and resolve issues directly. All data remains on your machine using a local SQLite database.
What you can do with it
- 1Streamline visual bug reportingA tester can quickly annotate a visual error using a pen or highlight tool and turn it into instructions.
- 2Manage bug lifecycles with AIDevelopers can ask their coding assistant to list all pending issues and update their status once repaired.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableduhuazhu/bugpack is public and reachablegithub.com/duhuazhu/bugpack ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-17github.com/duhuazhu/bugpack ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub
What is BugPack?
BugPack is a local-first tool that packages bug screenshots into structured, AI-ready fix instructions.
QA drops a screenshot in the chat → you Ctrl+V paste it into BugPack → annotate the issue → generate structured instructions → feed them to your AI coding agent.
Or skip the copy-paste entirely: BugPack's built-in MCP Server lets any MCP-compatible AI coding tool (Claude Code, Cursor, Windsurf, Cline, etc.) read bug context and fix code automatically.
Why BugPack?
AI coding agents changed how we write code, but not how we communicate bug context.
Every bug fix still requires: save screenshot → create file → write paths → describe the issue → paste to AI. 10 bugs a day = 1-2 hours of pure repetition.
BugPack compresses this to 30 seconds.
Requirements
- Node.js >= 18
- OS — Windows / macOS / Linux
- Browser — Chrome / Edge / Firefox (Chrome recommended)
Quick Start
npx bugpack-mcp
Open http://localhost:3456 and Ctrl+V your first bug screenshot to get started.
MCP Configuration
BugPack works with any MCP-compatible AI coding tool. Here are common examples — configure other tools the same way.
Claude Code — add to ~/.claude.json:
{
"mcpServers": {
"bugpack": {
"type": "stdio",
"command": "npx",
"args": ["bugpack-mcp", "--mcp"]
}
}
}
Cursor (.cursor/mcp.json):
{
"mcpServers": {
"bugpack": {
"command": "npx",
"args": ["bugpack-mcp", "--mcp"]
}
}
}
Windsurf (~/.codeium/windsurf/mcp_config.json):
{
"mcpServers": {
"bugpack": {
"command": "npx",
"args": ["bugpack-mcp", "--mcp"]
}
}
}
VS Code (.vscode/mcp.json):
{
"servers": {
"bugpack": {
"command": "npx",
"args": ["bugpack-mcp", "--mcp"]
}
}
}
Cline / Roo Code (VS Code Settings):
{
"cline.mcpServers": {
"bugpack": {
"command": "npx",
"args": ["bugpack-mcp", "--mcp"]
}
}
}
Trae (trae/mcp.json):
{
"mcpServers": {
"bugpack": {
"command": "npx",
"args": ["bugpack-mcp", "--mcp"]
}
}
}
MarsCode (Settings → MCP):
{
"mcpServers": {
"bugpack": {
"command": "npx",
"args": ["bugpack-mcp", "--mcp"]
}
}
}
Augment (augment/mcp.json):
{
"mcpServers": {
"bugpack": {
"command": "npx",
"args": ["bugpack-mcp", "--mcp"]
}
}
}
All other MCP-compatible tools follow the same pattern — just point command to npx and args to ["bugpack-mcp", "--mcp"].
Once configured, just tell your AI:
- "Show me pending bugs" → AI calls
list_bugs - "Fix bug #3" → AI calls
get_bug_context, locates code, and fixes it - "Mark bug #3 as fixed" → AI calls
mark_bug_status
OpenClaw Skills
BugPack provides OpenClaw Skills for AI agents that support the OpenClaw protocol.
Install via CLI:
clawhub install bugpack
Or add to ~/.openclaw/openclaw.json:
{
"skills": {
"entries": {
"bugpack": {
"enabled": true
}
},
"extraDirs": ["./skills"]
}
}
Or manually: copy the skills/ directory from this repo into your workspace or ~/.openclaw/skills/.
BugPack includes 3 built-in skills:
| Skill | Triggers | Description |
|---|---|---|
bugpack-list-bugs |
"show me bugs" / "list bugs" | List all bugs with status filtering |
bugpack-view-bug |
"view bug" / "bug context" | Get full bug details with screenshots and related files |
bugpack-fix-bug |
"fix bug" / "repair bug" | Read context → locate code → apply fix → update status |
Once installed, just tell your AI:
- "Show me bugs" → AI calls
bugpack-list-bugs - "View bug details" → AI calls
bugpack-view-bug, shows screenshots and context - "Fix this bug" → AI calls
bugpack-fix-bug, locates code, fixes it, and marks as done
Note: OpenClaw Skills require BugPack server running (
npx bugpack-mcp). Skills communicate with the local server via REST API onhttp://localhost:3456.
Features
Screenshots & Annotations
- Clipboard paste —
Ctrl+Vto paste screenshots directly from any chat tool - Drag & drop — drop image files onto the canvas
- 9 annotation tools — drag/pan, select, rectangle, arrow, text, numbering, highlight, pen, mosaic
- Compare mode — side-by-side comparison of "current" vs "expected" behavior
- Undo / Redo — full operation history
AI Instruction Generation
- One-click generation — produces structured Markdown fix instructions
- Universal MCP support — works with any MCP-compatible AI coding tool
MCP Server
Built-in MCP Server lets AI coding agents directly access bug context:
| Tool | Description |
|---|---|
list_bugs |
List all bugs with status/project filtering |
get_bug_context |
Get full bug context (description + screenshots + environment + files) |
get_bug_screenshot |
Get a single annotated screenshot (base64) |
mark_bug_status |
Update bug status |
add_fix_note |
Add fix notes after repair |
Platform Integrations
Import bugs from project management platforms, sync fix status back:
- Zentao · Jira · Linear · TAPD
More
- 100% local — data never leaves your machine, SQLite storage
- Multi-project — manage bugs independently per project
- Dark / Light theme — follow your preference
- i18n — Chinese / English
- Keyboard shortcuts — efficient workflow
Workflow
Paste screenshot → Describe issue → Generate instructions → AI fixes code
│ │ │
│ ┌──────────────┘ │
▼ ▼ ▼
BugPack Copy Markdown MCP Server
Canvas paste to AI tool AI reads & fixes directly
Data Storage
All data is stored locally:
- Data directory:
~/.bugpack/data/ - Database:
bugpack.db(SQLite) - Screenshots:
uploads/{ProjectName}/{uuid}.{ext}
Tech Stack
| Layer | Technology |
|---|---|
| Frontend | React 18 · TypeScript · Tailwind CSS · Zustand |
| Annotation | Fabric.js v6 |
| Backend | Node.js · Express |
| Database | SQLite (better-sqlite3, WAL mode) |
| MCP | @modelcontextprotocol/sdk |
Contributing
See CONTRIBUTING.md for guidelines.
License
If BugPack saves you time, give it a Star!
BugPack MCP questions
How does BugPack work with AI coding tools?
BugPack's built-in MCP Server allows compatible tools like Claude Code, Cursor, and Windsurf to read bug context and fix code automatically.
Can I use BugPack with existing project management tools?
Yes, you can import bugs from platforms like Jira, Linear, Zentao, and TAPD.
What annotation tools are available for screenshots?
It includes 9 annotation tools such as rectangle, arrow, text, numbering, highlight, pen, and mosaic.