ZenTao Bugs

基于 FastMCP 的禅道 Bug 管理 MCP 服务器，提供产品搜索、Bug 查询和解决功能。

javascript

5

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "evlon-mcp-zentao-bugs": {
      "command": "mcp-zentao-bugs",
      "args": [],
      "env": {
        "ZENTAO_ACCOUNT": "your-username",
        "ZENTAO_BASE_URL": "https://your-zentao.com",
        "ZENTAO_PASSWORD": "your-password"
      }
    }
  }
}

ZenTao Bugs MCP Server is a FastMCP-based server that enables product search, bug querying, and resolution actions for ZenTao. It authenticates automatically, streams logs and results, and helps you manage bugs efficiently from a single, MCP-compatible endpoint.

How to use

You run the MCP server locally and connect to it from your MCP client. The server authenticates with ZenTao on startup and maintains a live connection for both data and logs. Use the provided tools to search products, fetch the bugs assigned to you, view bug details, and mark bugs as resolved. Real-time status updates are delivered via Server-Sent Events, and you can inspect the server’s health and status through the health endpoint.

How to install

Prerequisites: you need Node.js installed on your machine. You will install the MCP server globally and then run it with your ZenTao credentials.

# Install the MCP server globally
npm install -g mcp-zentao-bugs

Start the server by providing your ZenTao connection details. You can set them via environment variables, a .env file, or a one-off command. The server will auto login on startup and expose HTTP Streaming and SSE endpoints for clients.

# Method 1: environment variables
export ZENTAO_BASE_URL="https://your-zentao.com"
export ZENTAO_ACCOUNT="your-username"
export ZENTAO_PASSWORD="your-password"
mcp-zentao-bugs

# Method 2: using a .env file
# in the current directory, create .env with:
# ZENTAO_BASE_URL=https://your-zentao.com
# ZENTAO_ACCOUNT=your-username
# ZENTAO_PASSWORD=your-password
mcp-zentao-bugs

# Method 3: a single command export
ZENTAO_BASE_URL="https://your-zentao.com" \
ZENTAO_ACCOUNT="your-username" \
ZENTAO_PASSWORD="your-password" \
mcp-zentao-bugs

Available tools

searchProducts

Search available ZenTao products by keyword and limit results to help you select the exact product name.

getMyBug

Fetch a single active bug assigned to you for a specific product, returning full bug details.

getMyBugs

Retrieve a list of bugs assigned to you for a specific product, with optional keyword filtering and status scope.

getNextBug

Get the next active bug assigned to you for a specific product using a generator-style pattern for efficient retrieval.

getBugStats

Obtain statistics about your assigned bugs for a product, including totals and active counts.

getBugDetail

Return full details of a bug, including raw HTML steps and any extracted image URLs.

markBugResolved

Mark a bug as resolved with an optional comment describing the fix.