Bugzilla

Bugzilla MCP 服务

一个 MCP 服务，可让 Claude 和其他 AI 助手在任何 Bugzilla 5.0+ 实例中搜索、查看、分诊并更新 Bug。

• 在你的机器上运行：你的 Bugzilla API 密钥不会离开本机。
• 默认只读：用于更改 Bugzilla 的工具默认关闭，只有在你启用后才会开放；update_bug 还支持试运行。
• 专为分诊打造：支持批量读取、历史记录、重复项、分类，以及以图片形式返回的屏幕截图。

📖 文档： bugzilla-mcp.vercel.app

要求

建议先在本地运行；如需试用且不想安装任何东西，可以使用托管服务。

	本地（推荐）	托管
Bugzilla	5.0+，且已启用 REST API	相同，但需可从互联网访问
API 密钥	从你的 Bugzilla 获取	相同
在你的机器上	uv 或 pipx（Claude Desktop 一键安装无需安装）	无需安装
MCP 客户端	任何可运行 stdio 服务的客户端	任何支持 HTTP 传输和自定义请求头的客户端
你的 API 密钥	保存在你的机器上	经由 bugzilla.fastmcp.app 传递
附件下载	支持	不支持

安装

Claude Desktop：一键安装

1. 从最新版本下载 bugzilla-mcp.mcpb。
2. 双击该文件（或打开 Settings → Extensions 并在那里安装）。
3. 输入你的 Bugzilla URL 和 API 密钥。除非你想让 Claude 更新 Bug，否则请保持勾选 Read-only。

无需安装 Python 或使用终端。Claude Desktop 会将 API 密钥作为机密保存。

Claude Code

安装一次 uv，然后：

claude mcp add bugzilla --scope user \
  -e BUGZILLA_URL=https://bugzilla.example.com \
  -e BUGZILLA_API_KEY=your-api-key \
  -- uvx bugzilla-mcp

在 bugzilla-mcp 后添加 --allow-writes，即可启用写入工具。使用 claude mcp list 检查。

Cursor、VS Code 和其他 MCP 客户端

{
  "mcpServers": {
    "bugzilla": {
      "command": "uvx",
      "args": ["bugzilla-mcp"],
      "env": {
        "BUGZILLA_URL": "https://bugzilla.example.com",
        "BUGZILLA_API_KEY": "your-api-key"
      }
    }
  }
}

如果客户端找不到 uvx（桌面应用不一定会加载 shell 的 PATH），请使用 which uvx 返回的完整路径。

pipx

pipx 会将 bugzilla-mcp 安装到独立环境中，并将命令添加到你的 PATH：

brew install pipx && pipx ensurepath   # macOS; see pipx docs for Linux/Windows
pipx install bugzilla-mcp
bugzilla-mcp --help

然后将 bugzilla-mcp 用作客户端命令，而不是 uvx bugzilla-mcp：

claude mcp add bugzilla --scope user \
  -e BUGZILLA_URL=https://bugzilla.example.com \
  -e BUGZILLA_API_KEY=your-api-key \
  -- bugzilla-mcp

如果桌面应用找不到它，请使用 which bugzilla-mcp 返回的完整路径（通常是 ~/.local/bin/bugzilla-mcp）。使用 pipx upgrade bugzilla-mcp 升级。

需要 Python 3.12+。如果 pipx 报告 "No matching distribution found"，说明它使用的是较旧版本的 Python（macOS 的 python3 是 3.9）：运行 pipx install --python python3.12 bugzilla-mcp。

选项

设置	方法	默认值
Bugzilla URL	BUGZILLA_URL	必填
API 密钥	BUGZILLA_API_KEY（仅限环境变量或 .env，不可作为标志传入）	必填
写入工具	--allow-writes 或 BUGZILLA_READ_ONLY=false	关闭
移除工具	BUGZILLA_DISABLED_TOOLS=update_bug,create_bug	无
供多位用户使用的 HTTP 服务	bugzilla-mcp --transport http --host 0.0.0.0 --port 8000	stdio

所有选项请参阅配置。

API 密钥

在 Bugzilla 的 Preferences → API Keys 中创建密钥（https://your-bugzilla/userprefs.cgi?tab=apikey）。该密钥拥有与你的账户相同的权限，因此使用权限受限的专用账户最安全。

工具

28 个工具，按功能分组。完整参考：用法。

分组	工具
读取	bug_info（默认精简模式，full / include_fields）、bug_comments、bug_history、bug_dependencies、duplicate_chain、bug_url、server_url
搜索	bugs_quicksearch、bugs_advanced_search、learn_quicksearch_syntax
附件	bug_attachments、get_attachment（图像以图像形式呈现，日志和补丁以文本形式呈现）、upload_attachment
批量处理与分类	bugs_info、bugs_comments、bugs_analysis_context、classify_bugs_heuristics、analyze_bugs_statistics
用户与产品	get_user、search_users、list_products、get_product_components
修改（启用写入前不可用）	update_bug（支持 dry_run）、create_bug、add_comment、tag_comment
仅限本地	download_attachments、download_attachment（保存到磁盘）

每个工具都带有 MCP 提示（只读 / 具有破坏性），因此客户端可以直接执行读取操作，并在修改前要求确认。

托管服务（FastMCP Cloud）

无需安装：连接到 https://bugzilla.fastmcp.app/mcp（托管于 FastMCP Cloud），并通过请求头发送凭据。

请求头	必需	值
api_key	是	你的 Bugzilla API 密钥
bugzilla_url	是	你的 Bugzilla 基础 URL（5.0+）
read_only	否	设为 false 可启用写入工具（默认为 true）

你的 API 密钥会经由托管服务传递给 Bugzilla。此方式适合体验；日常使用时，请本地安装。

Claude Code

claude mcp add --transport http bugzilla https://bugzilla.fastmcp.app/mcp --scope user \
  --header "api_key: your-api-key" \
  --header "bugzilla_url: https://bugzilla.example.com"

Claude Desktop（通过 mcp-remote，需要 Node.js）

{
  "mcpServers": {
    "bugzilla": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://bugzilla.fastmcp.app/mcp",
        "--header", "api_key:your-api-key",
        "--header", "bugzilla_url:https://bugzilla.example.com"
      ]
    }
  }
}

Cursor（.cursor/mcp.json）

{
  "mcpServers": {
    "bugzilla": {
      "url": "https://bugzilla.fastmcp.app/mcp",
      "headers": {
        "api_key": "your-api-key",
        "bugzilla_url": "https://bugzilla.example.com"
      }
    }
  }
}

VS Code（.vscode/mcp.json）

{
  "servers": {
    "bugzilla": {
      "type": "http",
      "url": "https://bugzilla.fastmcp.app/mcp",
      "headers": {
        "api_key": "your-api-key",
        "bugzilla_url": "https://bugzilla.example.com"
      }
    }
  }
}

在请求头中添加 read_only: false（对于 mcp-remote，使用 "--header", "read_only:false"）即可启用写入工具。更多信息：托管服务。

安全

• 服务默认以只读模式启动。只有在账户确实需要修改 Bug 时才启用写入。
• 请使用权限受限的专用 Bugzilla 账户；切勿使用管理员账户。
• 你的密钥会通过 X-BUGZILLA-API-KEY 请求头发送给 Bugzilla。标准版 Bugzilla 5.0/5.2 会忽略此请求头，因此会回退到 ?api_key=（已弃用；请勿让 Web 服务器的访问日志记录查询字符串）。

更多信息：安全。

开发

git clone https://github.com/SanthoshSiddegowda/bugzilla-mcp.git
cd bugzilla-mcp
uv sync --all-extras
uv run pytest tests
uv run bugzilla-mcp --help

贡献者须知见 CLAUDE.md。发布到 PyPI，并在发布 GitHub 版本时自动附带 Claude Desktop 扩展。

致谢

本项目受 Sai Karthik 的 mcp-bugzilla 启发。感谢你与 MCP 社区分享成果。如果你在寻找 openSUSE 的服务，请看 mcp-bugzilla，这是一个独立项目。

许可证

Apache 2.0