Bugzilla MCP (Santhosh Siddegowda)

Bugzilla MCP服务器

一种模型上下文协议（MCP）服务器，能够与Bugzilla实例进行安全交互。该服务器通过受控界面促进AI应用程序和Bugzilla错误跟踪系统之间的通信。

快速开始

托管服务器：使用生产服务器 https://bugzilla.fastmcp.app/mcp -无需本地设置！只需使用Bugzilla API密钥和实例URL将其添加到MCP客户端配置中。

特性

• 查询bug信息和评论
• 使用Bugzilla的快速搜索语法搜索错误
• 为bug添加注释（公共或私有）
• 通过HTTP标头进行安全访问
• 全面的错误处理

配置

服务器需要HTTP标头进行身份验证。使用以下标头配置MCP客户端：

• api_key （必需）-您的Bugzilla API密钥

- 从以下位置获取API密钥： https://your-bugzilla-instance.com/userprefs.cgi?tab=apikey

• bugzilla_url （必填）-Bugzilla实例的基本URL

- 例子： https://bugzilla.test.org

用法

使用克劳德桌面

将此添加到您的 claude_desktop_config.json:

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

备注：对于当地发展，使用 http://127.0.0.1:8000/mcp 相反。

使用游标IDE

将此添加到您的 .cursor/mcp.json:

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

备注：对于当地发展，使用 http://127.0.0.1:8000/mcp 相反。

使用Visual Studio代码

将此添加到您的 mcp.json:

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

备注：对于当地发展，使用 http://127.0.0.1:8000/mcp 相反。

在本地运行服务器

对于当地发展：

# Using uv (recommended)
uv sync
uv run python server.py

# Or with standard Python
pip install fastmcp httpx python-dotenv
python server.py

服务器将在以下时间启动 http://127.0.0.1:8000/mcp/

生产服务器：托管版本可在以下网址获得 https://bugzilla.fastmcp.app/mcp -您可以在MCP客户端配置中直接使用此URL，而无需在本地运行服务器。

发展

# Clone the repository
git clone 
cd bugzilla-mcp

# Create virtual environment
python -m venv venv
source venv/bin/activate  # or `venv\Scripts\activate` on Windows

# Install dependencies
uv sync

# Inspect the server
fastmcp inspect server.py:mcp

安全注意事项

• 永远不要提交API密钥或凭据
• 使用具有最低权限的API密钥
• 考虑对生产使用实施限速
• 在生产环境中使用HTTPS作为Bugzilla URL

安全最佳实践

此MCP实现需要Bugzilla API访问功能。为了安全起见：

1. 创建一个专用的Bugzilla API密钥 具有最低权限
2. 从不使用管理帐户 或完全访问API密钥
3. 限制API密钥权限 只进行必要的操作
4. 定期安全审查 API密钥使用的

⚠️ 重要：在配置API访问时，始终遵循最小权限原则。

致谢

这个项目的灵感来自 赛Karthik的mcp bugzilla 项目。他使用FastMCP为Bugzilla构建MCP服务器的工作提供了宝贵的见解和灵感。感谢您分享您的经验并为MCP生态系统做出贡献！

许可证

Apache 2.0许可证-有关详细信息，请参阅许可证文件。