Zentao MCP Server

A Model Context Protocol (MCP) server for integrating with the Zentao API. This server provides tools to access project management data from Zentao directly through MCP-compatible interfaces.

Features

• Authentication: Automatically handles login and token management for Zentao.

• MCP Tools:

  • zentao_get_task_details: Get detailed information about a specific task by ID.

  • zentao_get_bug_details: Get detailed information about a specific bug.

  • zentao_download_attachment: Download file attachments from ZenTao (e.g., bug/task images or videos).

Related MCP server: Zendesk API MCP Server

Requirements

• Node.js (v18 or higher recommended)

• A Zentao instance accessible via API

Installation

1. Clone the repository:

   git clone https://github.com/dyno-nexsoft/zentao_mcp.git
   cd zentao_mcp

2. Install dependencies:

   npm install

3. Configure environment variables: Create a .env file in the root directory and add the following configurations:

   ZENTAO_BASE_URL=https://your-zentao-url.com/api.php/v1
   ZENTAO_ACCOUNT=your_username
   ZENTAO_PASSWORD=your_password

Usage

This server communicates via standard input/output (stdio), making it compatible with any MCP client that supports stdio transport.

Integrating with MCP Clients (Claude Desktop, Cursor, etc.)

Once published to npm or GitHub, users can integrate this server into their MCP clients easily. Add the following to your MCP client configuration (e.g., claude_desktop_config.json):

{
  "mcpServers": {
    "zentao": {
      "command": "npx",
      "args": [
        "-y",
        "@dyno181cm.nexsoft/zentao_mcp"
      ],
      "env": {
        "ZENTAO_BASE_URL": "https://your-zentao-url.com/api.php/v1",
        "ZENTAO_ACCOUNT": "your_username",
        "ZENTAO_PASSWORD": "your_password"
      }
    }
  }
}

Available Tools

• zentao_get_task_details

  • Inputs:

    • taskId (string | number) - Required. Task ID.

• zentao_get_bug_details

  • Inputs:

    • bugId (string | number) - Required. Bug ID.

• zentao_download_attachment

  • Inputs:

    • fileId (string | number) - Required. File ID to download.

    • extension (string) - Optional. File extension (e.g., mp4, png).