MCP Bugzilla

Requirements

• Python 3.13
• A Bugzilla instance with REST API access
• A Bugzilla user account with an API key
• Network access to the Bugzilla server

Installation

Docker / Podman

The easiest way to run the server is using Docker or Podman:

docker pull kskarthik/mcp-bugzilla
docker run -p 8000:8000 \
  -e BUGZILLA_SERVER=https://bugzilla.example.com \
  kskarthik/mcp-bugzilla \
  --bugzilla-server https://bugzilla.example.com \
  --host 0.0.0.0 \
  --port 8000

Official Docker Hub repository: https://hub.docker.com/r/kskarthik/mcp-bugzilla/

Usage

Examples

Example 1: Get Bug Information

```python

Example 2: Search for Bugs

```python

Example 3: Add a Comment

```python

Example 4: Get Bug History and Comments

```python

Example 5: Quicksearch Syntax Examples

```python

Example 6: Using with Red Hat Bugzilla

Red Hat Bugzilla requires Authorization header authentication: ```bash

Example 7: Update Bug Status

```python

Example 8: Assign a Bug

```python

Example 9: Mark as Duplicate

```python

Configuration

Environment Variables

You can configure the server using environment variables instead of command-line arguments:

```bash export BUGZILLA_SERVER=https://bugzilla.example.com export MCP_HOST=127.0.0.1 export MCP_PORT=8000 export MCP_API_KEY_HEADER=ApiKey export LOG_LEVEL=INFO # Optional: DEBUG, INFO, WARNING, ERROR, CRITICAL export MCP_READ_ONLY=true # Optional: set to true to disable write operations

Selective Disabling Tools (Optional)

Endpoint

The MCP server exposes an HTTP endpoint at:

http://<host>:<port>/mcp/

For example, with default settings:

http://127.0.0.1:8000/mcp/

API Reference

API Errors

Issue: Receiving ToolError with HTTP status codes

Common causes: - 401 Unauthorized: Invalid or expired API key - 404 Not Found: Bug ID doesn't exist or you don't have permission to view it - 403 Forbidden: Insufficient permissions for the requested operation - 500 Internal Server Error: Bugzilla server error

Solution: Check the error message for details and verify your API key permissions.

MCP Client Integration

The server follows the Model Context Protocol (MCP) specification. It can be integrated with any MCP-compatible client.

Example MCP client configuration (format may vary by client):

{
  "mcpServers": {
    "bugzilla": {
      "url": "http://127.0.0.1:8000/mcp/",
      "headers": {
        "ApiKey": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Search by component

bugs_quicksearch("component:Core status:RESOLVED")

Troubleshooting