# 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:**
    ```bash
    uv init --app
    ```
2.  **Add Dependencies:**
    ```bash
    uv add mcp
    ```

## Running & Testing

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

```bash
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!)*

```json
{
  "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!