Bugzilla MCP
Getting Started

Installation

Get started with Bugzilla MCP Server.

Quick Start (Hosted Server)

The easiest way to get started is to use the hosted production server. No installation or local setup required!

  1. Get your Bugzilla API key from your Bugzilla instance:
    • Navigate to: https://your-bugzilla-instance.com/userprefs.cgi?tab=apikey
    • Generate a new API key if you don't have one
  2. Configure your MCP client (see Configuration for details):
    • Add the server URL: https://bugzilla.fastmcp.app/mcp
    • Add your API key and Bugzilla URL as headers

That's it! You're ready to use the Bugzilla MCP Server.

Local Development

If you want to run the server locally for development or testing:

Prerequisites

  • Python 3.13 or higher
  • uv package manager (recommended) or pip

Install dependencies

Using uv (recommended):

Terminal
uv sync

Or with standard Python:

Terminal
pip install fastmcp httpx python-dotenv

Run the server

Using uv:

Terminal
uv run python server.py

Or with standard Python:

Terminal
python server.py

The server will start at http://127.0.0.1:8000/mcp/

Configure your MCP client

For local development, use http://127.0.0.1:8000/mcp as the server URL in your MCP client configuration.

Development Setup

For contributing to the project:

Clone the repository

Terminal
git clone <repository-url>
cd bugzilla-mcp

Create virtual environment

Terminal
python -m venv venv
source venv/bin/activate  # or `venv\Scripts\activate` on Windows

Install dependencies

Terminal
uv sync

Inspect the server

You can inspect the MCP server to see available tools:

Terminal
fastmcp inspect server.py:mcp

This will show you all available tools, their parameters, and descriptions.

Next Steps

Introduction

Welcome to Bugzilla MCP Server documentation.

Configuration

Configure the Bugzilla MCP Server with your MCP client.