内容
<div align="center">
**MCP 服务器用于 Bugzilla — 通过 Bugzilla REST API 搜索、讨论和管理 Firefox/Mozilla 错误。**
<a href="https://kud.io/projects/mcp-bugzilla">官方网站</a> · <a href="https://kud.io/projects/mcp-bugzilla/docs">文档</a>
</div>
## 功能特点
- **错误查找** — 通过 ID 或别名获取任何错误，包括其完整的字段变更历史。
- **强大的搜索** — 按产品、组件、状态、严重程度、指派人、关键词或自由文本 `quicksearch` 进行筛选。
- **评论线程** — 读取错误的所有评论，发布新评论，并标记评论（例如垃圾信息，需要信息）。
- **附件管理** — 列出、上传和更新补丁和文件；内联设置审查标志。
- **写入支持** — 创建和更新错误，变更状态，添加抄送成员，并标记重复错误 — 所有这些都需要通过 API 密钥进行身份验证，因此只读使用不需要凭证。
- **产品和用户发现** — 枚举产品、组件、版本、标志类型、字段定义，并通过电子邮件查找用户。
## 安装
将服务器注册到您的 MCP 客户端。对于 Claude Desktop，请在您的 `claude_desktop_config.json` 中添加以下内容：
```json
{
"mcpServers": {
"mcp-bugzilla": {
"command": "npx",
"args": ["-y", "@kud/mcp-bugzilla"],
"env": {
"MCP_BUGZILLA_API_KEY": "您的 API 密钥"
}
}
}
}
```
`MCP_BUGZILLA_API_KEY` 是可选的 — 如果不需要写入权限，请省略它以获得只读访问权限。要获取密钥，请访问您的 [Bugzilla API 密钥](https://bugzilla.mozilla.org/userprefs.cgi?tab=apikey) 首选项页面。
`MCP_BUGZILLA_BASE_URL` 环境变量覆盖了自托管实例的默认端点（`https://bugzilla.mozilla.org/rest`）。
## 使用
服务器在六个区域暴露了 17 种工具。标记为 🔑 的工具需要 `MCP_BUGZILLA_API_KEY`。
| 工具 | 区域 | 认证 | 描述 |
| --- | --- | --- | --- |
| `get_bug` | 错误 | — | 通过 ID 或别名获取单个错误 |
| `search_bugs` | 错误 | — | 使用筛选器或全文 `quicksearch` 搜索 |
| `create_bug` | 错误 | 🔑 | 提交新错误 |
| `update_bug` | 错误 | 🔑 | 更新字段、状态、关键词、抄送或关闭为重复 |
| `get_bug_history` | 错误 | — | 获取错误的字段变更历史 |
| `get_comments` | 评论 | — | 获取所有评论，可选按日期筛选 |
| `create_comment` | 评论 | 🔑 | 发布评论，可选带有工作时间记录 |
| `search_comment_tags` | 评论 | — | 搜索可用的评论标签名称 |
| `update_comment_tags` | 评论 | 🔑 | 在评论上添加或删除标签 |
| `get_attachments` | 附件 | — | 列出错误的附件 |
| `create_attachment` | 附件 | 🔑 | 上传补丁或文件（base64 编码） |
| `update_attachment` | 附件 | 🔑 | 重命名、标记为过时或更改附件的标志 |
| `get_products` | 产品 | — | 列出可访问的产品 |
| `get_product` | 产品 | — | 获取产品详情，包括组件和版本 |
| `get_user` | 用户 | — | 通过电子邮件或登录名查找用户 |
| `get_bug_fields` | 字段 | — | 列出错误字段及其合法值 |
| `get_flag_types` | 标志 | — | 列出产品/组件的标志类型 |
## 开发
```sh
git clone https://github.com/kud/mcp-bugzilla.git
cd mcp-bugzilla
npm install
npm run dev
```
| 脚本 | 描述 |
| --- | --- |
| `npm run build` | 编译 TypeScript 到 `dist/` |
| `npm run dev` | 直接通过 `tsx` 运行源码 |
| `npm test` | 运行 Vitest 测试套件 |
| `npm run typecheck` | 类型检查不含编译 |
| `npm run inspect:dev` | 打开 MCP Inspector 对抗源码 |
📚 **完整文档 → [mcp-bugzilla/docs](https://kud.io/projects/mcp-bugzilla/docs)**
