zentao-mcp

MCP server for ZenTao RESTful APIs (products + bugs).

Quick Start

Cursor IDE

1. Open Cursor Settings (⌘, on Mac or Ctrl+, on Windows/Linux)
2. Navigate to Features → Model Context Protocol
3. Click Edit Config to open ~/.cursor/mcp.json (or create it)
4. Add the following configuration:

{
  "mcpServers": {
    "zentao-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@leeguoo/zentao-mcp",
        "--zentao-url=https://zentao.example.com/zentao",
        "--zentao-account=leo",
        "--zentao-password=***",
        "--stdio"
      ]
    }
  }
}

5. Restart Cursor IDE

Other MCP Clients (Claude Desktop, etc.)

For clients using TOML configuration (e.g., Claude Desktop), add to your MCP config file:

[mcp_servers."zentao-mcp"]
command = "npx"
args = [
  "-y",
  "@leeguoo/zentao-mcp",
  "--zentao-url=https://zentao.example.com/zentao",
  "--zentao-account=leo",
  "--zentao-password=***",
  "--stdio"
]

Config file locations:

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.toml (Mac) or %APPDATA%\Claude\claude_desktop_config.toml (Windows)
• Cursor: ~/.cursor/mcp.json (JSON format)

Configuration

Required Parameters

You can configure the server using CLI arguments or environment variables:

CLI Arguments:

• --zentao-url (e.g. https://zentao.example.com/zentao)
• --zentao-account
• --zentao-password

Environment Variables:

• ZENTAO_URL (e.g. https://zentao.example.com/zentao)
• ZENTAO_ACCOUNT
• ZENTAO_PASSWORD

Using Environment Variables in Cursor

If you prefer to use environment variables instead of CLI args, you can configure them in Cursor:

{
  "mcpServers": {
    "zentao-mcp": {
      "command": "npx",
      "args": ["-y", "@leeguoo/zentao-mcp", "--stdio"],
      "env": {
        "ZENTAO_URL": "https://zentao.example.com/zentao",
        "ZENTAO_ACCOUNT": "leo",
        "ZENTAO_PASSWORD": "***"
      }
    }
  }
}

Tip: ZENTAO_URL should include the ZenTao base path (often /zentao).

Tools

The MCP server provides four tools that can be triggered by natural language in Cursor:

• zentao_products_list - List all products
• zentao_bugs_list - List bugs for a specific product
• zentao_bugs_stats - Get bug statistics across products
• zentao_bugs_mine - List my bugs by assignment or creator (status filter supported)

Usage Examples

After configuring the MCP server in Cursor, you can use natural language to interact with ZenTao:

English:

• "Show me all products"
• "List bugs for product 1"
• "Show me bugs"
• "What's the bug statistics?"
• "Show my bugs"
• "List bugs assigned to me"
• "View bugs in product 2"

Chinese (中文):

• "看bug" / "查看bug" / "显示bug"
• "产品1的bug列表"
• "bug统计"
• "显示所有产品"
• "查看产品2的问题"
• "我的bug"
• "分配给我的bug"

The AI will automatically:

1. Use zentao_products_list to get product IDs when needed
2. Use zentao_bugs_list when you ask to see bugs
3. Use zentao_bugs_stats when you ask for statistics or overview
4. Use zentao_bugs_mine when you ask for your own bugs

Tool Parameters

zentao_products_list:

{
  "page": 1,
  "limit": 1000
}

zentao_bugs_list:

{
  "product": 1,
  "page": 1,
  "limit": 20
}

zentao_bugs_stats:

{
  "includeZero": false,
  "limit": 1000
}

zentao_bugs_mine:

{
  "status": "active",
  "scope": "assigned",
  "includeZero": false,
  "includeDetails": true,
  "maxItems": 50
}

Local Development

pnpm install
ZENTAO_URL=https://zentao.example.com/zentao \\
ZENTAO_ACCOUNT=leo \\
ZENTAO_PASSWORD=*** \\
pnpm start

Security

Do not commit credentials. Prefer environment variables in local runs.