mcp-server-tapd

@tapd_mcp/mcp-server-tapd
Hosted
1 Stars 2.2k 次浏览 tapd_mcp 更新于 2026-08-23

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

开发者工具

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

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

该服务需要配置环境变量：BOT_URL、TAPD_API_BASE_URL、TAPD_API_PASSWORD、TAPD_API_USER、TAPD_BASE_URL

可用工具 （21 个）

该服务在 MCP 协议中暴露的工具，AI 可按需调用

get_stories 2 个参数 需填 1 项

获取 TAPD 需求，如果没有 limit 参数，则需要同时调用 get_story_count 工具获取需求数量 TAPD API 文档：https://open.tapd.cn/document/api-doc/API%E6%96%87%E6%A1%A3/api_reference/story/get_stories.html Args: workspace_id: 项目ID（必填） options: 可选参数字典，支持以下字段： - id: ID - name: 标题，支持模糊匹配，例如："%需求%" 等等... Returns: <str> # 需求所有字段数据的 json 格式，返回需求链接给用户，链接要可点击，链接的格式。而且需要返回剩余的需求数量，让用户确定是否需要继续获取剩余的需求 Note: 需求链接格式为 {tapd_base_url}/{workspace_id}/prong/stories/view/{story_id} Note: 如果没有给limit 参数，则需要提醒用户剩余的需求数量

必填参数：workspace_id

get_story_custom_fields 1 个参数 需填 1 项

获取 TAPD 需求自定义字段配置 Args: workspace_id: 项目ID（必填） Returns: <str> # 需求所有自定义字段配置数据的 json 格式

必填参数：workspace_id

get_story_count 2 个参数 需填 1 项

获取 TAPD 需求数量 TAPD API 文档：https://open.tapd.cn/document/api-doc/API%E6%96%87%E6%A1%A3/api_reference/story/get_stories_count.html Args: workspace_id: 项目ID（必填） options: 可选参数字典，支持以下字段： - id: ID - name: 标题 等等... Returns: <str> # 需求所有字段数据的 json 格式

必填参数：workspace_id

update_story 2 个参数 需填 1 项

更新 TAPD 需求 TAPD API 文档：https://open.tapd.cn/document/api-doc/API%E6%96%87%E6%A1%A3/api_reference/story/update_story.html Args: workspace_id: 项目ID（必填，格式如：59271484） options: 可选参数字典，支持以下字段： - id: 需求ID（必填，格式如：1159271484001002933） - name: 标题 - description: 需求描述 等等... Returns: <str>, # 需求所有字段数据的 json 格式 Note: 需求链接格式为 {tapd_base_url}/{workspace_id}/prong/stories/view/{story_id}

必填参数：workspace_id

create_story 3 个参数 需填 2 项

创建 TAPD 需求 TAPD API 文档：https://open.tapd.cn/document/api-doc/API%E6%96%87%E6%A1%A3/api_reference/story/add_story.html Args: workspace_id: 项目ID（必填） name: 需求标题（必填） options: 可选参数字典，支持以下字段： - priority_label: 优先级 - description: 需求描述，用富文本格式 等等... Returns: { "data": <str>, # 需求所有字段数据的 json 格式 "url": <str> # 需求 url，返回给用户时，链接要可点击 }

必填参数：workspace_id、name

get_bug 2 个参数 需填 1 项

获取 TAPD 缺陷 TAPD API 文档：https://open.tapd.cn/document/api-doc/API%E6%96%87%E6%A1%A3/api_reference/bug/get_bugs.html Args: workspace_id: 项目ID（必填） options: 可选参数字典，支持以下字段： - id: ID - title: 标题 等等... Returns: <str> # 缺陷所有字段数据的 json 格式

必填参数：workspace_id

get_bug_custom_fields 1 个参数 需填 1 项

获取 TAPD 缺陷自定义字段配置 Args: workspace_id: 项目ID（必填） Returns: <str> # 需求所有自定义字段配置数据的 json 格式

必填参数：workspace_id

get_bug_count 2 个参数 需填 1 项

获取 TAPD 缺陷 TAPD API 文档：https://open.tapd.cn/document/api-doc/API%E6%96%87%E6%A1%A3/api_reference/bug/get_bugs_count.html Args: workspace_id: 项目ID（必填） options: 可选参数字典，支持以下字段： - id: ID - name: 标题 等等... Returns: <str> # 需求所有字段数据的 json 格式

必填参数：workspace_id

update_bug 2 个参数 需填 1 项

更新 TAPD 缺陷 TAPD API 文档：https://open.tapd.cn/document/api-doc/API%E6%96%87%E6%A1%A3/api_reference/bug/update_bug.html Args: workspace_id: 项目ID（必填） options: 可选参数字典，支持以下字段： - id: 缺陷ID（必填） - title: 标题 - description: 描述 等等... Returns: <str> # 缺陷所有字段数据的 json 格式

必填参数：workspace_id

create_bug 3 个参数 需填 2 项

创建 TAPD 缺陷 TAPD API 文档：https://open.tapd.cn/document/api-doc/API%E6%96%87%E6%A1%A3/api_reference/bug/add_bug.html Args: workspace_id: 项目ID（必填） title: 缺陷标题（必填） options: 可选参数字典，支持以下字段： - priority_label: 优先级 - description: 描述 等等... Returns: { "data": <str>, # 所有字段数据的 json 格式 "url": <str> # url，返回给用户时，链接要可点击 }

必填参数：workspace_id、title

create_comments 2 个参数 需填 1 项

添加评论 TAPD API 文档：https://open.tapd.cn/document/api-doc/API%E6%96%87%E6%A1%A3/api_reference/comment/add_comment.html Args: workspace_id: 项目ID（必填） options: 可选参数字典，支持以下字段： - entry_id: 评论所依附的业务对象实体id（必填，格式如：1159271484001002933） - entry_type: 评论类型（取值： bug、 bug_remark （流转缺陷时候的评论）、 stories、 tasks 。）（必填） - author: 评论人（必填） - description: 内容（必填） - root_id: 根评论ID - reply_id: 需求评论回复的ID Returns: <str> # 新建评论的数据

必填参数：workspace_id

get_workflows_all_transitions 2 个参数 需填 1 项

获取项目下的工作流流转细则，例如要流转到"实现中"，则需要调用这个工具查看当前状态能流转到的状态 Args: workspace_id: 项目ID（必填） options: - system: 系统名。取 bug （缺陷的）或者 story（需求的）（必填） - workitem_type_id: 需求类别ID（必填） Returns: <str> 状态流转细则

必填参数：workspace_id

get_workflows_status_map 2 个参数 需填 1 项

获取工作流状态中英文名对应关系，例如想要获取所有"实现中"的需求/缺陷等，可以调用这个接口先获取状态的英文名，再根据这个英文名作为 status 字段的值去查询 Args: workspace_id: 项目ID（必填） options: - system: 系统名。取 bug （缺陷的）或者 story（需求的）（必填） - workitem_type_id: 需求类别ID（必填） Returns: <str> 状态流转细则

必填参数：workspace_id

get_workitem_types 2 个参数 需填 1 项

获取符合查询条件的所有需求类别（分页显示，默认一页30条） TAPD API 文档：https://open.tapd.cn/document/api-doc/API%E6%96%87%E6%A1%A3/api_reference/story/get_workitem_types.html Args: workspace_id: 项目ID（必填） options: - id: id，支持多ID查询 - name: 需求类别名称 等等... Returns: <str> 项目下所有需求类别字段数据

必填参数：workspace_id

get_workflows_last_steps 2 个参数 需填 1 项

获取工作流结束状态，一次只能获取一个项目的工作流结束状态 Args: workspace_id: 项目ID（必填） options: - system: 系统名。取 bug （缺陷的）或者 story（需求的）（必填） - workitem_type_id: 需求类别id（不传则取项目下所有工作流的结束状态） - type: 节点类型，仅并行工作流需区分。status 状态，step 并行工作流节点。默认只返回结束状态。若需要同时返回结束状态和结束节点，支持数组type[]=status&type[]=step Returns: <str> 工作流结束状态

必填参数：workspace_id

get_stories_custom_fields_settings 1 个参数 需填 1 项

获取需求自定义字段配置，一次只能获取一个项目的配置 Args: workspace_id: 项目ID（必填） Returns: <str> 需求自定义字段配置

必填参数：workspace_id

get_stories_fields_lable 1 个参数 需填 1 项

获取需求所有字段的中英文 Args: workspace_id: 项目ID（必填） Returns: <str>

必填参数：workspace_id

get_stories_fields_info 1 个参数 需填 1 项

获取需求所有字段及候选值，返回符合查询条件的所有需求字段及候选值。 部分字段为静态候选值，建议参考下方 "可选值说明"部分。其余动态字段（如：status(状态)/iteration_id(迭代)/categories(需求分类)），需要通过该接口获取对应的候选值（中英文映射） Args: workspace_id: 项目ID（必填） Returns: <str>

必填参数：workspace_id

get_workspace_info 1 个参数 需填 1 项

根据项目ID（workspace_id）获取项目信息，包含项目ID,项目名称,状态,创建时间,创建人等信息 Args: workspace_id: 项目ID（必填） Returns: <str>

必填参数：workspace_id

get_iterations 2 个参数 需填 1 项

根据项目ID（workspace_id）获取符合查询条件的所有迭代，例如可以通过名称获取迭代 id，然后作为iteration_id字段的值获取到迭代下的需求或缺陷 Args: workspace_id: 项目ID（必填） options: - id: ID - name: 标题 - startdate: 开始时间 - enddate: 结束时间 ... Returns: <str>

必填参数：workspace_id

send_qiwei_message 1 个参数 需填 1 项

发送信息到企业微信群 Args: msg: 推送的企业微信的信息，Markdown 格式（必填） Returns: <str>

必填参数：msg

服务介绍

TAPD MCP Server

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

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

System requirements

  • uv
  • TAPD API Token

Setup Guide

Install uv

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

Get TAPD API Token

Get API tokens from: https://www.tapd.cn/open_platform/open_api_redirect

  1. 未注册，请前往 注册
  2. 已注册但未授权API，请前往API配置：登录TAPD，点击进入“公司管理-API账号管理”，复制API账号和API密钥
  3. 参数
  • TAPD_API_USER: API账号
  • TAPD_API_PASSWORD: API密钥
  • BOT_URL: 企业微信机器人 webhook 地址，选填，如果需要发送消息到企业微信群才需要填

Configuration and Usage

Claude Desktop Setup

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

Cursor IDE Setup

  1. Open Cursor Settings
  2. Navigate to Features > MCP Servers
  3. Click Add new MCP server

For stdio transport:

name: mcp-server-tapd
type: command
command: uvx mcp-server-tapd --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
查看源码 项目主页

相关 MCP 服务

LeetCode(力扣)
jinzcdev/leetcode-mcp-server
MCP 服务器实现 LeetCode API 集成，支持自动化获取编程题库、用户数据和竞赛信息。
可视化图表-MCP-Server
antvis/mcp-server-chart
这是一个基于AntV的模型上下文协议服务器，用于生成图表。它支持超过20种类型的图表，并且可以与多种桌面应用程序和平台一起使用。
微软Playwright
@microsoft/playwright-mcp
一种模型上下文协议服务器，它使大型语言模型能够通过结构化的可访问性快照与网页交互，而无需使用视觉模型或截图。
MCP上下文模型文档
@upstash/context7-mcp
一种模型上下文协议服务器，它从库中直接获取最新、特定版本的文档和代码示例并将其引入LLM提示中，帮助开发人员在无需过时或虚构信息的情况下获得准确的答案。