Bugzilla MCP server
2026년 11월 14일 커밋Bugzilla 인스턴스를 통해 AI 클라이언트가 버그 정보를 조회하고, 댓글을 관리하며, 히스토리를 추적하고, 버그 워크플로우를 자동화할 수 있도록 지원합니다.
다른 이름 openSUSE/mcp-bugzilla
- 스타
- 15
- Tools
- 24
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 14일
- 라이선스
- —
Bugzilla MCP란?
Bugzilla은(는) MCP server입니다. Bugzilla 인스턴스를 통해 AI 클라이언트가 버그 정보를 조회하고, 댓글을 관리하며, 히스토리를 추적하고, 버그 워크플로우를 자동화할 수 있도록 지원합니다. 24개 도구를 제공합니다. 예: bug_info, bug_history, bug_comments.
프로젝트 README에서 생성된 요약
Bugzilla MCP server 정보
mcp-bugzilla는 AI 클라이언트 내부에서 버그 추적 워크플로우를 관리하고 이슈 데이터를 조회할 수 있게 해줍니다. 개발자와 QA 엔지니어는 이 MCP server를 사용하여 Bugzilla 인스턴스와 상호작용할 수 있으며, 모델이 상세한 버그 정보를 검색하고 변경 히스토리를 검토하며 토론 스레드를 읽을 수 있습니다. 이 서버는 컨텍스트 과부하를 방지하기 위해 특정 작성자를 제외하거나 반환되는 댓글 수를 제한하는 등 대량의 데이터를 필터링하는 특화된 도구를 제공합니다.
사용자는 버그 상태 업데이트, 특정 이메일 주소로 이슈 할당, 새 댓글 추가와 같은 쓰기 작업을 수행할 수 있습니다. 또한 서버는 파일 첨부도 처리하여 메타데이터를 목록화하거나 패치 및 로그를 다운로드할 수 있습니다. 설정에 따라 첨부 파일은 텍스트나 base64 형태로 인라인 반환하거나 로컬 디렉토리에 직접 저장할 수 있습니다. 수정 작업을 수행하려면 적절한 Bugzilla 권한이 필요하며, Model Context Protocol을 통해 기존 Bugzilla 환경에 연결됩니다.
활용 사례
- 1버그 생명주기 변경 사항 요약다른 필드 업데이트로 인한 노이즈를 피하기 위해, AI에게 특정 버그의 상태 및 해결 방식 변경 사항만 보여달라고 요청합니다.
- 2이슈 할당 자동화AI에게 설명 댓글과 함께 특정 개발자에게 버그를 할당하도록 지시합니다.
- 3관련 패치 검색특정 버그에 대해 패치로 표시된 가장 최근의 첨부 파일 목록만 요청합니다.
- 4봇 노이즈 필터링릴리스 모니터링 봇이 생성한 자동 메시지를 무시하고 최근 댓글만 가져옵니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Bugzilla MCP 도구 24
README에서 감지됨bug_infobug_historybug_commentsget_component_defaultsadd_commentlist_attachmentsdownload_attachmentupdate_bug_statusassign_bugupdate_bug_fieldsadd_cc_to_bugmark_as_duplicate
| bug_info | — | |
| bug_history | — | |
| bug_comments | — | |
| get_component_defaults | — | |
| add_comment | — | |
| list_attachments | — | |
| download_attachment | — | |
| update_bug_status | — | |
| assign_bug | — | |
| update_bug_fields | — | |
| add_cc_to_bug | — | |
| mark_as_duplicate | — |
도구 24개 모두 보기도구 수 줄이기
create_bugadd_attachmentbugs_quicksearchquicksearch_syntax_resourcesummarize_bug_promptbug_urlbugzilla_versionbugzilla_extensionsbugzilla_timebugzilla_parametersmcp_server_info_resourceget_current_headers_resource
| create_bug | — | |
| add_attachment | — | |
| bugs_quicksearch | — | |
| quicksearch_syntax_resource | — | |
| summarize_bug_prompt | — | |
| bug_url | — | |
| bugzilla_version | — | |
| bugzilla_extensions | — | |
| bugzilla_time | — | |
| bugzilla_parameters | — | |
| mcp_server_info_resource | — | |
| get_current_headers_resource | — |
구성
BUGZILLA_API_KEYBUGZILLA_AUTH_MODEBUGZILLA_SERVERLOG_LEVELMCP_AUTH_HEADERMCP_BUGZILLA_DISABLED_METHODSMCP_HOSTMCP_PORTMCP_READ_ONLY
| 이름 | 설명 | 유형 |
|---|---|---|
| BUGZILLA_API_KEY | — | |
| BUGZILLA_AUTH_MODE | — | |
| BUGZILLA_SERVER | — | |
| LOG_LEVEL | — | |
| MCP_AUTH_HEADER | — | |
| MCP_BUGZILLA_DISABLED_METHODS | — | |
| MCP_HOST | — | |
| MCP_PORT | — | |
| MCP_READ_ONLY | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능opensuse/mcp-bugzilla is public and reachablegithub.com/opensuse/mcp-bugzilla ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)No license결함 발견
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-11github.com/opensuse/mcp-bugzilla ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음24 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기Bugzilla Model Context Protocol (MCP) Server
A robust MCP server that provides seamless interaction with Bugzilla instances through the Model Context Protocol. This server exposes a comprehensive set of tools and prompts, enabling AI models and other MCP clients to efficiently query bug information, manage comments, and leverage Bugzilla's powerful quicksearch capabilities.
Table of Contents
- Features
- Requirements
- Installation
- Configuration
- Usage
- API Reference
- Examples
- Troubleshooting
- License
Features
Tools
The server provides the following tools for interacting with Bugzilla:
Bug Information
-
bug_info(bug_ids: list[int], include_fields: Optional[str] = None, exclude_fields: Optional[str] = None): Retrieves comprehensive details for specified Bugzilla bug IDs. By default every field is returned; use Bugzilla's native field selection to trim large or bulk fetches.- Parameters:
bug_ids: A list of bug IDs to fetch details forinclude_fields: Comma-separated field names to return (Bugzilla's nativeBug.getparameter; supports field groups and_default/_all/_extra). For the leanest response request only scalar fields, e.g."id,status,resolution,summary". Requesting a user field (assigned_to,creator,cc,qa_contact) also returns its verbose*_detailobject. Defaults to all fieldsexclude_fields: Comma-separated field names to drop. To remove a user-object expansion, exclude both the base field and its*_detailtogether, e.g."cc,cc_detail"— excluding the*_detailalone has no effect, as Bugzilla re-attaches it while the base field is present
- Returns: A dictionary containing the array
bugswhich lists the requested information about the bugs (status, assignee, summary, description, extensions, etc.) - Note on Bugzilla API parity: both
include_fieldsandexclude_fieldsare native BugzillaBug.getparameters, forwarded to the API unchanged; the underlying request is standard Bugzilla - Example:
bug_info([12345, 67890], include_fields="id,status,resolution,summary")fetches two bugs with just the essential scalar fields
- Parameters:
-
bug_history(bug_id: int, new_since: Optional[datetime] = None, changed_fields: Optional[str] = None, exclude_authors: Optional[str] = None, limit: Optional[int] = None): Fetches the change history of a given bug ID, with SQL-like controls to keep only the change events that matter for triage.- Parameters:
bug_id: The bug ID to fetch history fornew_since: Optional datetime object to only return history newer than this timechanged_fields: Comma-separated Bugzilla field names; keep only changes to these fields, dropping events left with no matching change (e.g."status,resolution,assigned_to"to see only lifecycle changes and hide the cc / flagtypes.name / summary churn that dominates most histories)exclude_authors: Comma-separated substrings; drop events whose author matches any (e.g."upstream-release-monitoring"to hide release-monitoring bot edits)limit: Return only the most recent N events (chronological order preserved)
- Returns: A list of history-event dictionaries, each containing
when,who, and achangeslist (each change hasfield_name,added, andremoved) - Note on Bugzilla API parity:
new_sincemirrors Bugzilla's own API parameter.changed_fields,exclude_authors, andlimithave no server-side Bugzilla equivalent — this server applies them client-side, as post-processing over the standardBug.historyresponse; the underlying Bugzilla request is unmodified - Example:
bug_history(2504555, changed_fields="status,resolution")returns just the event where the bug was closed as RAWHIDE, filtering out the surrounding cc and needinfo-flag churn
- Parameters:
-
bug_comments(bug_id: int, include_private_comments: bool = False, new_since: Optional[datetime] = None, include_fields: Optional[str] = "count,id,creator,creation_time,text,attachment_id,is_private", exclude_creators: Optional[str] = None, limit: Optional[int] = None): Fetches comments associated with a given bug ID, with SQL-like controls to keep only what is needed and avoid flooding the context on large threads.- Parameters:
id: The bug ID to fetch comments forinclude_private_comments: Whether to include private comments (default:False)new_since: Optional datetime object to only return comments newer than this timeinclude_fields: Comma-separated field names to keep per comment (default:count,id,creator,creation_time,text,attachment_id). PassNoneto return every fieldexclude_creators: Comma-separated substrings; drop comments whose creator matches any (e.g."upstream-release-monitoring"to hide release-monitoring/bot noise)limit: Return only the most recent N comments (chronological order preserved)
- Returns: A list of comment dictionaries. By default each contains
count,id,creator,creation_time,text, andattachment_id; passinclude_fields=Nonefor the full objects (which also includecreator_id,bug_id,tags,time, andis_private) - Note on Bugzilla API parity:
new_sinceandinclude_fieldsmirror Bugzilla's own API parameters of the same names (include_fieldsis applied client-side here).exclude_creatorsandlimithave no server-side Bugzilla equivalent — this server applies them client-side, as post-processing over the standardBug.commentsresponse; the underlying Bugzilla request is unmodified. - Example:
bug_comments(12345, exclude_creators="upstream-release-monitoring", limit=5)returns the 5 most recent comments that aren't from the release-monitoring bot
- Parameters:
-
get_component_defaults(component: str = None, product: str = None, bug_id: int = None): Looks up a component's default assignee and QA contact, read from the parent product since Bugzilla has no component endpoint.- Parameters:
component: Component name (resolved frombug_idif omitted)product: Product the component belongs to (resolved frombug_idif omitted)bug_id: Resolve product/component from this bug instead of passing them
- Returns: A dictionary with
product,component,default_assignee,default_qa_contact,is_active - Example:
get_component_defaults(bug_id=12345)returns the defaults for that bug's component. To reset a bug to these defaults, useupdate_bug_fields(..., reset_qa_contact=True).
- Parameters:
-
add_comment(bug_id: int, comment: str, is_private: bool = False): Adds a new comment to a specified bug.- Parameters:
bug_id: The bug ID to add a comment tocomment: The comment text to addis_private: Whether the comment should be private (default:False)
- Returns: A dictionary containing the ID of the newly created comment
- Example:
add_comment(12345, "Fixed in version 2.0", is_private=False)
- Parameters:
Attachments
-
list_attachments(bug_id: int, exclude_obsolete: bool = False, patches_only: bool = False, limit: Optional[int] = None): Lists a bug's attachments as metadata only (the base64 file contents are excluded to keep responses small), with filters to cut the noise on bugs that accumulate many attachments.- Parameters:
bug_id: The bug whose attachments to listexclude_obsolete: Drop attachments flagged obsolete (is_obsolete). Note: some bots (e.g. release-monitoring) never set this flag, so it only helps where obsolete is actually usedpatches_only: Keep only attachments flagged as patches (is_patch)limit: Return only the most recent N attachments (chronological order preserved)
- Returns: A list of attachment metadata objects (
id,file_name,summary,content_type,size,is_private,is_obsolete,is_patch,creation_time, ...). Use anidwithdownload_attachmentto fetch the file. - Note on Bugzilla API parity:
exclude_obsolete,patches_only, andlimithave no server-side Bugzilla equivalent — this server applies them client-side, as post-processing over the standard attachment metadata; the underlying Bugzilla request is unmodified - Example:
list_attachments(2381747, patches_only=True, limit=3)returns the 3 most recent patch attachments
- Parameters:
-
download_attachment(attachment_id: int, output_dir: Optional[str] = None, delivery: "auto" | "inline" | "save" = "auto", include_private: bool = False): Downloads a single attachment by id. Thedeliveryargument lets the caller choose how the content is returned.- Parameters:
attachment_id: The attachment id to download (discover vialist_attachments)output_dir: Optional directory to save the file in when it is written to disk. Defaults to the server's configured download directory (--download-dir/BUGZILLA_DOWNLOAD_DIR).delivery:auto(default): textual attachments (logs, patches, plain/xml/json, ...) up to 256 KiB are returned inline as decodedcontent; binary attachments, or larger text, are written to disk.inline: always return the content in the response — decodedcontentfor text, or base64data_base64for binary (and for text whose bytes are not valid UTF-8). Refused above 1 MiB.save: always write the file to disk and return itspath.
include_private: Whether to download a private attachment (default:False); a private attachment is refused unless this is set toTrue.
- Returns: Text inline:
{"mode": "text", "content": <decoded text>, ...metadata}. Binary inline:{"mode": "base64", "data_base64": <base64>, ...metadata}. On disk:{"mode": "saved", "path": <absolute path>, ...metadata}. The saved file is named<attachment_id>-<sanitized file_name>. - Example:
download_attachment(685495)·download_attachment(685495, delivery="save")
- Parameters:
Write Operations
Note: Write operations require appropriate Bugzilla permissions. These tools enable bug management and workflow automation.
-
update_bug_status(bug_id: int, status: str, resolution: str = None, comment: str = ""): Updates the status of a bug with optional comment.- Parameters:
bug_id: The bug ID to updatestatus: New status (e.g.,NEW,ASSIGNED,MODIFIED,ON_QA,VERIFIED,CLOSED)resolution: Required when status isCLOSED(e.g.,FIXED,WONTFIX,NOTABUG,DUPLICATE)comment: Optional comment explaining the status change
- Returns: A dictionary containing the updated bug fields
- Example:
update_bug_status(12345, "CLOSED", resolution="FIXED", comment="Fixed in version 2.0")
- Parameters:
-
assign_bug(bug_id: int, assignee: str, comment: str = ""): Assigns a bug to a user.- Parameters:
bug_id: The bug ID to assignassignee: Email address of the assigneecomment: Optional comment explaining the assignment
- Returns: A dictionary containing the updated bug fields
- Example:
assign_bug(12345, "developer@example.com", comment="You're the expert on this component")
- Parameters:
-
update_bug_fields(bug_id: int, priority: str = None, severity: str = None, resolution: str = None, custom_fields: dict = None, reset_qa_contact: bool = False, reset_assigned_to: bool = False, comment: str = ""): Updates various bug fields.- Parameters:
bug_id: The bug ID to updatepriority: Priority level (e.g.,urgent,high,medium,low,unspecified)severity: Severity level (e.g.,urgent,high,medium,low,unspecified)resolution: Resolution (only for closed bugs)custom_fields: Dict of custom fields, e.g.{"cf_fixed_in": "1.2.3"}reset_qa_contact: IfTrue, reset the QA contact to the component's defaultreset_assigned_to: IfTrue, reset the assignee to the component's defaultcomment: Optional comment explaining the changes
- Returns: A dictionary containing the updated bug fields
- Example:
update_bug_fields(12345, priority="high", severity="urgent", comment="Escalating due to customer impact") - Example:
update_bug_fields(12345, reset_qa_contact=True)resets the QA contact to the component default
- Parameters:
-
add_cc_to_bug(bug_id: int, cc_email: str): Adds an email address to the CC list of a bug.- Parameters:
bug_id: The bug IDcc_email: Email address to add to CC list
- Returns: A dictionary containing the updated bug fields
- Example:
add_cc_to_bug(12345, "manager@example.com")
- Parameters:
-
mark_as_duplicate(bug_id: int, duplicate_of: int, comment: str = ""): Marks a bug as a duplicate of another bug and closes it.- Parameters:
bug_id: The bug ID to mark as duplicateduplicate_of: The bug ID this is a duplicate ofcomment: Optional comment (auto-generated if not provided)
- Returns: A dictionary containing the updated bug fields including status
CLOSED, resolutionDUPLICATE, anddupe_ofreference - Example:
mark_as_duplicate(12345, 789012, comment="Same root cause as the original report")
- Parameters:
-
create_bug(product, component, summary, version, description, op_sys="All", platform="All", priority=None, severity=None, cc=None, custom_fields=None): Files a new bug.- Parameters:
product,component,summary,version,description: Required core fieldsop_sys,platform: Default toAllpriority,severity: Optional, instance-specific valuescc: Optional list of email addresses to CCcustom_fields: Optional dict of extra/custom fields (e.g.{"cf_fixed_in": "1.2.3"})
- Returns: A dictionary with the new bug
id. If the Bugzilla instance mandates additional fields, its error message is surfaced so you can retry with them. - Example:
create_bug("MyProduct", "general", "App crashes on launch", "unspecified", "Steps to reproduce: ...")
- Parameters:
-
add_attachment(bug_id, file_name, summary, data, content_type="text/plain", is_patch=False, is_private=False, comment=""): Attaches a file to a bug.- Parameters:
bug_id: The bug to attach tofile_name: File name shown in Bugzillasummary: Short description of the attachmentdata: The attachment content, base64-encodedcontent_type: MIME type (ignored whenis_patch=True)is_patch: Mark the attachment as a patchis_private: Restrict to the insider groupcomment: Optional comment added alongside the attachment
- Returns: A dictionary with the created attachment
ids - Example:
add_attachment(12345, "crash.log", "Crash log", "aGVsbG8=", content_type="text/plain")
- Parameters:
Bug Search
-
bugs_quicksearch(query: str, include_fields: str = "...", limit: int = 50, offset: int = 0, order: str = "relevance"): Executes a search for bugs using Bugzilla's powerful quicksearch syntax.- Parameters:
query: A quicksearch query string (e.g.,"product:Firefox")include_fields: Comma-separated list of fields to return (default:"id,product,component,assigned_to,status,resolution,summary,last_change_time")limit: Maximum number of results to return (default:50)offset: Number of results to skip for pagination (default:0)order: Sort order (default:"relevance"). For field searches, use"bug_id DESC"to sort newest bugs first, or"changeddate DESC"to sort by recently modified.
- Returns: A list of dictionaries, each containing essential bug fields
- Example:
bugs_quicksearch("product:Firefox status:NEW", limit=10, order="bug_id DESC")
- Parameters:
-
quicksearch_syntax_resource(): Returns documentation on Bugzilla's quicksearch syntax.- Returns: A string containing Markdown documentation.
-
summarize_bug_prompt(bug_id: int): Returns a detailed summary prompt for all comments of a given bug ID.- Returns: A well-structured summary of the bug's comments including usernames (bold italic) and dates (bold).
Utility Tools
-
bug_url(bug_id: int): Constructs and returns the direct URL to a specific bug on the Bugzilla server.- Returns: A string representing the bug's URL (e.g.,
"https://bugzilla.example.com/show_bug.cgi?id=12345")
- Returns: A string representing the bug's URL (e.g.,
-
bugzilla_version(): Returns the version of the Bugzilla server.- Returns: A string representing the Bugzilla version (e.g.,
"5.0.4").
- Returns: A string representing the Bugzilla version (e.g.,
-
bugzilla_extensions(): Returns the extensions installed on the Bugzilla server.- Returns: A dictionary containing installed Bugzilla extensions and their metadata.
-
bugzilla_time(): Returns the current time and timezone of the Bugzilla server.- Returns: A dictionary containing server time (
db_time,web_time,web_time_utc) and timezone details (tz_name,tz_offset,tz_short_name).
- Returns: A dictionary containing server time (
-
bugzilla_parameters(names: list[str] = None): Returns the configuration parameters of the Bugzilla server.- Parameters:
names: Optional list of parameter names to filter results
- Returns: A dictionary containing Bugzilla configuration parameters.
- Parameters:
-
mcp_server_info_resource(): Returns the configuration arguments being used by the current server instance (version, host, port, etc.).- Returns: A dictionary containing server configuration.
-
get_current_headers_resource(): Returns the HTTP headers from the current request.- Returns: A dictionary of HTTP headers.
Requirements
- Python 3.13
- A Bugzilla instance with REST API access
- A Bugzilla user account with an API key (optional: public instances support anonymous access)
- Network access to the Bugzilla server
Installation
PyPI
The easiest way to install and run mcp-bugzilla is using uv:
Option 1: Using uvx (Recommended - No Installation Required)
Run the server directly without installing it:
uvx mcp-bugzilla --bugzilla-server https://bugzilla.example.com
This will automatically download and run the latest version.
Option 2: Install with uv pip
If you prefer to have mcp-bugzilla installed in your system:
# Install the package
uv pip install mcp-bugzilla
# Run the server
mcp-bugzilla --bugzilla-server https://bugzilla.example.com
Option 3: Install in a Virtual Environment
Create an isolated environment for mcp-bugzilla:
# Create a virtual environment
uv venv mcp-bugzilla-env
source mcp-bugzilla-env/bin/activate # On Windows: mcp-bugzilla-env\Scripts\activate
# Install the package
uv pip install mcp-bugzilla
# Run the server
mcp-bugzilla --bugzilla-server https://bugzilla.example.com
Note: If you don't have uv installed, install it first from https://github.com/astral-sh/uv#installation
From Source
-
Clone the repository:
git clone <repository-url> cd mcp-bugzilla -
Install dependencies:
uv sync -
Run the server:
uv run mcp-bugzilla --bugzilla-server https://bugzilla.example.com --host 127.0.0.1 --port 8000This will start the HTTP server at
http://127.0.0.1:8000/mcp/.
Docker
Pull the pre-built image from the openSUSE registry:
docker pull registry.opensuse.org/opensuse/mcp-bugzilla:latest
Run the container:
docker run -p 8000:8000 \
registry.opensuse.org/opensuse/mcp-bugzilla:latest \
--bugzilla-server https://bugzilla.example.com \
--host 0.0.0.0 \
--port 8000
You can also pass configuration via environment variables:
docker run -p 8000:8000 \
-e BUGZILLA_SERVER=https://bugzilla.example.com \
-e MCP_HOST=0.0.0.0 \
-e MCP_PORT=8000 \
registry.opensuse.org/opensuse/mcp-bugzilla:latest
Podman works identically — just substitute docker with podman.
Configuration
Command-Line Arguments
The mcp-bugzilla command supports the following options:
| Argument | Environment Variable | Default | Description |
|---|---|---|---|
--bugzilla-server <URL> |
BUGZILLA_SERVER |
Required | Base URL of the Bugzilla server (e.g., https://bugzilla.example.com) |
--transport {http,stdio} |
MCP_TRANSPORT |
http |
Transport for the MCP server. stdio is for direct subprocess launches by an MCP client; http exposes a network endpoint |
--host <ADDRESS> |
MCP_HOST |
127.0.0.1 |
Host address for the MCP server to listen on (http transport only) |
--port <PORT> |
MCP_PORT |
8000 |
Port for the MCP server to listen on (http transport only) |
--mcp-auth-header <HEADER> |
MCP_AUTH_HEADER |
none | HTTP header name that clients use to send the Bugzilla API key to this MCP server (http transport only). When not specified, inbound header authentication is disabled and client headers are ignored. |
--bugzilla-api-key <KEY> |
BUGZILLA_API_KEY |
none | Static Bugzilla API key. Optional: if omitted and not provided per-request via --mcp-auth-header (http), access is anonymous. For --transport stdio this is the only source of the key |
--bugzilla-auth-mode {query,bearer} |
BUGZILLA_AUTH_MODE |
query |
How to authenticate with Bugzilla: query sends ?api_key=<KEY> (default, works with most instances); bearer sends Authorization: Bearer <KEY> header (required for Red Hat Bugzilla and similar) |
--read-only |
MCP_READ_ONLY |
False |
Disables all tools which can modify a bug. Works well in conjunction with MCP_BUGZILLA_DISABLED_METHODS |
--tool-search |
MCP_TOOL_SEARCH |
False |
Collapse all tools into search_tools + call_tool meta-tools using BM25 relevance ranking. The LLM searches for tools by natural language query and calls them directly. Reduces context overhead when many tools are available |
--download-dir <DIR> |
BUGZILLA_DOWNLOAD_DIR |
<tmpdir>/mcp-bugzilla |
Directory where download_attachment writes binary/oversized attachments. The default directory is created on first use and restricted to the owner (0o700); an explicit output_dir keeps its own permissions |
Note: --host and --port are rejected with an error when used together with --transport stdio.
Note: Command-line arguments take precedence over environment variables.
Deprecated Arguments
The following arguments are deprecated and will be removed in a future release. They continue to work and emit a warning in the logs when used. Migrate to the replacements shown:
| Deprecated | Replacement | Notes |
|---|---|---|
--api-key / BUGZILLA_API_KEY (old semantics) |
--bugzilla-api-key / BUGZILLA_API_KEY |
Same env var; the new arg makes the intent explicit. Previously required for stdio; now optional (anonymous if absent) |
--api-key-header / MCP_API_KEY_HEADER |
--mcp-auth-header / MCP_AUTH_HEADER |
Clarifies that this controls the inbound client→MCP header |
--use-auth-header |
--bugzilla-auth-mode bearer |
Replaces a boolean flag with an explicit mode choice |
Bugzilla MCP 질문
Bugzilla MCP는 어떤 도구를 제공하나요?
24개 도구를 제공합니다. 예: bug_info, bug_history, bug_comments, get_component_defaults, add_comment.
특정 변경 사항만 확인하도록 버그 히스토리를 필터링할 수 있나요?
네, changed_fields 파라미터를 사용하여 상태(status)나 해결 방식(resolution)과 같은 특정 필드의 변경 사항만 유지할 수 있어 불필요한 정보를 걸러내는 데 도움이 됩니다.
서버에서 버그 상태 업데이트를 지원하나요?
네, update_bug_status 도구를 사용하여 버그의 상태와 해결 방식을 변경할 수 있으며, 변경 이유를 설명하는 댓글을 선택적으로 추가할 수 있습니다.