Bugpack
Package bug screenshots into AI-ready fix instructions with MCP Server
What is Bugpack?
Bugpack is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to package bug screenshots into ai-ready fix instructions with mcp server
Package bug screenshots into AI-ready fix instructions with MCP Server
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Package bug screenshots into AI-ready fix instructions with
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx bugpackConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Bugpack
BugPack is an MCP server that bridges the gap between bug reporting and AI-powered code fixing by letting developers paste, annotate, and package bug screenshots into structured Markdown fix instructions that any AI coding assistant can act on immediately. It runs a local web interface on port 3456 where you can paste screenshots from the clipboard, annotate them with arrows and callouts, and store everything in a local SQLite database. AI clients connected via MCP can then call tools to list bugs, retrieve full context including annotated screenshots, and mark issues as resolved — all without leaving the coding environment.
Prerequisites
- Node.js 18 or later
- npx available (bundled with Node.js/npm)
- A modern browser (Chrome recommended) for the annotation interface at localhost:3456
- An MCP-compatible AI client such as Claude Desktop, Claude Code, Cursor, or Windsurf
Start the BugPack server
Run BugPack with npx. It starts the web interface on port 3456 and an MCP stdio server simultaneously.
npx bugpack-mcpOpen the bug annotation interface
Navigate to the local web interface in Chrome or Edge to start capturing and annotating screenshots.
open http://localhost:3456Capture and annotate a bug screenshot
Press Ctrl+V (or Cmd+V on macOS) to paste a screenshot from your clipboard directly into the interface, then use the nine annotation tools to mark the relevant areas.
Configure Claude Code as the MCP client
Add BugPack to your Claude Code MCP configuration so the AI agent can read bug context automatically.
# Add to ~/.claude.json
{
"mcpServers": {
"bugpack": {
"type": "stdio",
"command": "npx",
"args": ["bugpack-mcp", "--mcp"]
}
}
}Configure other MCP clients (Cursor, Windsurf, VS Code)
For other MCP-compatible tools, add the same command/args in their respective config files.
{
"mcpServers": {
"bugpack": {
"command": "npx",
"args": ["bugpack-mcp", "--mcp"]
}
}
}Bugpack Examples
Client configuration
Claude Desktop configuration to connect to BugPack's MCP stdio server.
{
"mcpServers": {
"bugpack": {
"command": "npx",
"args": ["bugpack-mcp", "--mcp"]
}
}
}Prompts to try
Natural language prompts you can use with an AI agent once BugPack is connected.
- "Show me all pending bugs in the dashboard project"
- "Get the full context for bug #3 including the screenshot"
- "Fix the UI layout bug shown in bug #5 and mark it as resolved"
- "Add a fix note to bug #2 explaining what was changed"
- "List all bugs that haven't been fixed yet"Troubleshooting Bugpack
Port 3456 is already in use when starting BugPack
Stop any existing BugPack process or other service using port 3456. Find the process with `lsof -i :3456` on macOS/Linux or `netstat -ano | findstr :3456` on Windows, then kill it.
Screenshots are not persisting between sessions
BugPack stores all data in ~/.bugpack/data/ using SQLite. Verify this directory exists and is writable. If it is corrupted, delete ~/.bugpack/data/bugpack.db to reset the database (this deletes all stored bugs).
AI agent cannot connect to BugPack MCP server
Ensure BugPack is running with the --mcp flag: `npx bugpack-mcp --mcp`. The MCP server uses stdio, so it must be running as a subprocess of your MCP client, not as a standalone server.
Frequently Asked Questions about Bugpack
What is Bugpack?
Bugpack is a Model Context Protocol (MCP) server that package bug screenshots into ai-ready fix instructions with mcp server It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Bugpack?
Follow the installation instructions on the Bugpack GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Bugpack?
Bugpack works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Bugpack free to use?
Yes, Bugpack is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Bugpack Alternatives — Similar Developer Tools Servers
Looking for alternatives to Bugpack? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Bugpack in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Bugpack?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.