ZenTao

Provides MCP access to ZenTao RESTful API v1 with automatic token handling and common call utilities.

javascript

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 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": {
    "valiant-cat-zentao-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@makun111/zentao-mcp-server"
      ],
      "env": {
        "ZENTAO_TOKEN": "<auto_fetched_token>",
        "ZENTAO_ACCOUNT": "your_account",
        "ZENTAO_BASE_URL": "https://example.com/zentao/",
        "ZENTAO_PASSWORD": "your_password"
      }
    }
  }
}

This ZenTao MCP Server enables you to access ZenTao RESTful API v1 through a lightweight MCP layer that handles token management automatically, and provides a simple way to call any REST endpoint and browse key resources from your MCP client.

How to use

You interact with the ZenTao MCP Server through an MCP client. First, obtain a token so your client can authenticate with ZenTao, then use the generic call tool to access ZenTao RESTful v1 endpoints or rely on dedicated helper tools to list projects, search products, or manage defects.

The server exposes a minimal set of operations you’ll typically perform from a client, such as getting a token, invoking RESTful endpoints like /projects or /departments, and using specialized helpers to fetch defects assigned to you. All requests automatically include a Token header once you have a valid token, so you don’t need to manually attach authentication details to every call.

How to install

Choose one of the installation methods below to get started.

Quick start (npm)Install the MCP server globally so it can be invoked directly by your MCP client.

# Global install
npm install -g @makun111/zentao-mcp-server

Additional configuration and running notes

For local development or debugging, you can install from source, set environment variables, and run the server directly.

git clone git@github.com:Immmmmmortal1/zantao.git
cd zantao
npm install

Security and environment configuration

Prepare the environment variables that the server uses to connect to ZenTao and manage authentication tokens.

export ZENTAO_BASE_URL="https://example.com/zentao/"
export ZENTAO_ACCOUNT="你的账号"
export ZENTAO_PASSWORD="你的密码"
# Optional if you already have a token
export ZENTAO_TOKEN=""

Using the MCP client configuration (example)

Configure your MCP client to run this server via stdio. This example uses npx to start the MCP server.

# Zentao MCP server (stdio, npm)
[mcp_servers.zentao_server]
type = "stdio"
command = "npx"
args = ["-y", "@makun111/zentao-mcp-server"]

Usage hints

From your MCP client, you can perform actions like obtaining a token, listing departments, creating projects, or querying defects assigned to you using the generic call tool and the provided endpoints.

Available tools

get_token

Obtain a token by sending a request to the tokens endpoint. The token is cached by default and can be force-refreshed.

call

Call any ZenTao RESTful v1 endpoint using a path, method, and optional query or body. The server automatically injects the Token header.

getMyBugs

Query defects assigned to the current user with optional filters for product and status; supports fetching the next item to process.

Built by

VeilStrat

AI signals for GTM teams