Skip to main content

TAPD MCP Server

TAPD 是腾讯敏捷研发管理平台,覆盖需求、计划、研发、测试、发布研发全生命周期。支持用自然语言与 TAPD 对话,实现需求、缺陷、任务、迭代等管理。

  • 与 TAPD API 无缝集成,提升开发效率

TAPD MCP 使用文档

系统要求

  • uv
  • TAPD Access Token(推荐)或 TAPD API 账号密码

快速开始

Install uv

brew install uv
# OR
curl -LsSf https://astral.sh/uv/install.sh | sh

参数

  • TAPD_ACCESS_TOKEN: 个人令牌(推荐)
  • TAPD_API_USER: API账号
  • TAPD_API_PASSWORD: API密钥
  • BOT_URL: 企业微信机器人 webhook 地址,如果需要发送消息到企业微信群才需要填(选填)

注意 TAPD_API_USER/TAPD_API_PASSWORD(TAPD API 账号密码) 与 TAPD_ACCESS_TOKEN(TAPD 个人授权令牌)为两种调用 MCP 的凭据,选一种即可。

获取 TAPD Access Token(推荐)

TAPD_ACCESS_TOKEN 为 TAPD 个人令牌,在 我的设置-个人访问令牌 点“创建个人访问令牌”,令牌只显示一次,注意保存下来。

获取 API 账号密码(兼容)

  1. 未注册,请前往 注册
  2. 已注册但未授权API,请前往API配置:登录TAPD,点击进入 公司管理-API账号管理,复制API账号和API密钥

IDE 配置

CodeBuddy / Claude Desktop / Cursor

本地 stdio 运行,环境变量配置示例(推荐个人 Token)

{
  "mcpServers": {
    "mcp-server-tapd": {
      "command": "uvx",
      "args": ["mcp-server-tapd"],
      "env": {
        "TAPD_ACCESS_TOKEN": "",
        "TAPD_API_USER": "",
        "TAPD_API_PASSWORD": "",
        "TAPD_API_BASE_URL": "https://api.tapd.cn",
        "TAPD_BASE_URL": "https://www.tapd.cn",
        "BOT_URL": ""
      }
    }
  }
}

Streamable HTTP 配置

使用 Streamable HTTP 替代 stdio

  1. 在终端手动启动服务
git clone https://cnb.cool/tapd_mcp/mcp-server-tapd.git

cd mcp-server-tapd/src/mcp_server_tapd

uv venv && source .venv/bin/activate

uv pip install requests markdown mcp mcp_server_tapd

python server.py --mode=streamable-http --host="0.0.0.0" --port=8000 --api-user=your_api_user --api-password=your_api_password --api-base-url=https://api.tapd.cn --tapd-base-url=https://www.tapd.cn  --bot-url="https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=XXX"

# 如果使用个人 Token,则将 --api-user=your_api_user --api-password=your_api_password 替换为 --access-token=您的个人Token

  1. 通过如下配置连接到已启动的服务
{
  "mcpServers": {
    "tapd_mcp_http": {
      "url": "http://localhost:8000/mcp/"
    }
  }
}

Metadata

Release files for mcp-server-tapd 8.0.83

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcp-server-tapd 8.0.83
File Size Uploaded Provenance Actions
mcp_server_tapd-8.0.83.tar.gz 27.1 kB Without provenance Details for mcp_server_tapd-8.0.83.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for mcp-server-tapd 8.0.83
File Interpreter ABI Platform Actions
mcp_server_tapd-8.0.83-py3-none-any.whl Python 3 none any Details for mcp_server_tapd-8.0.83-py3-none-any.whl

Total release size: 54.0 kB

Release files / mcp_server_tapd-8.0.83.tar.gz

Download URL mcp_server_tapd-8.0.83.tar.gz
Size 27.1 kB
Tags Source
SHA-256 checksum
How to use checksums
44adf01c017a01b1e08c685282ee04d84bcd30fbb9d58bab86322924ef07895d
BLAKE2b-256 checksum
How to use checksums
d9e8418eed0064308390a52c3309dbbcb588367a56bb70aac2f873110db85b9d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.2

Release files / mcp_server_tapd-8.0.83-py3-none-any.whl

Download URL mcp_server_tapd-8.0.83-py3-none-any.whl
Size 26.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4a4f09795fbccbed7c5075c83ee9ebe5aecdc2e260a1b3897e143acef5e1b248
BLAKE2b-256 checksum
How to use checksums
f5a425ed763e8064d3f533d71a18e33fe9b1ca2e1032258aa34a4c606ffdeba2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.2

Security for mcp-server-tapd 8.0.83

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

8.0.83 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page