BugForge MCP: Smart Defect Reporter

A Model Context Protocol (MCP) server that exposes a Defect Summary Generator prompt template. It helps turn raw, messy bug notes into structured defect reports (Summary, Steps, Expected vs Actual, and Priority) using an AI client.

Quick Setup

This project uses uv for isolated Python dependencies and execution speed.

1. Initialize the Environment:

   uv init --app
   

2. Add Dependencies:

   uv add mcp
   

Running & Testing

To simulate an AI assistant connecting to this prompt server over Stdio, we have a included test client script:

uv run client_test.py

This script spawns the server as a background process, queries the available prompt templates, fills in sample arguments, and displays the template instructions received back from the server.

Connecting to Claude Desktop

To use this prompt directly from your Claude Desktop interface, you can add it to your configuration.

1. Open your Claude config file at: ~/Library/Application Support/Claude/claude_desktop_config.json

2. Add the "qa-prompt-server" connection inside "mcpServers".

( Note: Make sure to replace with your absolute user path since Desktop apps don't load your shell profile by default!)

{
  "mcpServers": {
    "qa-prompt-server": {
      "command": "path/to/uv",
      "args": [
        "--directory", 
        "path/to/your/project", 
        "run", 
        "mcp_server.py"
      ]
    }
  }
}

How to use in Claude:

1. Restart Claude Desktop completely.
2. Click the + (plus) icon on your message text input line.
3. Select Connectors.
4. Navigate to Add from qa-prompt-server ➔ Select Defect Summary Generator.
5. Fill in your bug description, click the confirmation button (like Add to chat) to attach it, then hit the main Send button to see the structured output!