MCP.Market

TAPD MCP Server

by sun-jingtao·io.github.sun-jingtao/tapd-mcp-server·v1.0.8
No reviews yet

在 Cursor/Copilot 中查询、分析和回填 TAPD bug / 需求

B78/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B78/100

full report

Adoption
Growing

0 stars195 downloads/wk

Reviews

Write one

Nobody has reviewed TAPD MCP Server yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

TAPD MCP Server tools (18, 4 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • tapd_append_bug_description_image

    一步完成：上传图片 → 读取缺陷当前描述 → 把图片追加到描述末尾后整体回写。先读后写避免覆盖原有正文。仅支持 png/gif/jpg/jpeg/bmp、单张 ≤5MB。图片上传成功但描述写入失败时会明确提示（此时图片已上传，可改用 tapd_writeback 手动写回）。

  • tapd_call_api

    通用透传工具：直接调用 TAPD OpenAPI（https://api.tapd.cn）的任意 REST 接口，用于专用工具未覆盖的场景（任务、工时、测试计划、模块/版本配置、Wiki、看板等）。

  • tapd_create_bugwrite action

    在 TAPD 中创建一个已确认的新 bug，可选关联到指定需求，支持设置处理人、优先级、严重程度、模块、版本、迭代、排期、各类人员（测试/开发/参与人等）、工时、模板、自定义字段等。创建前建议先用 tapd_search_users 确认处理人的 nick；不传处理人则默认指派给当前登录用户。

  • tapd_create_storywrite action

    在 TAPD 中创建一个已确认的新需求，支持设置处理人、优先级、迭代、父需求、标签、排期、工时、自定义字段等。创建前建议先用 tapd_search_users 确认处理人的 nick；不传处理人则默认指派给当前登录用户。

  • tapd_get_bugs

    批量获取多个 TAPD bug 的完整内容，包括描述、复现步骤、评论、附件、图片和视频等详细信息。状态会附带项目工作流中文名（如「已解决（resolved）」）

  • tapd_get_stories

    批量获取多个 TAPD 需求的完整内容，包括描述、评论、附件、图片和视频等详细信息。状态会附带项目工作流中文名（如「已实现（resolved）」）

  • tapd_list_bug_changes

    查询 TAPD bug 变更历史。bug_id、created 与 id 至少提供一个；可按变更人、变更字段过滤并自定义排序，include_add_bug=true 时返回创建缺陷的记录。状态变更会附带项目工作流中文名（如「接受/处理（in_progress） => 已解决（resolved）」）。

  • tapd_list_bugs

    查询 TAPD bug 列表，默认查询当前登录用户负责的缺陷；传入 current_owner 可查询指定处理人名下的缺陷。传入 id 或 story_id 时不限处理人（story_id 返回该需求全部处理人名下的关联缺陷），可查到已转给他人的缺陷；显式传入 current_owner 时再按该处理人取交集。传入 workspace_id 时只查该项目；不传 workspace_id 时会聚合处理人参与的所有项目的缺陷（按 story_id 过滤时仍需具体项目）。支持按字段过滤：缺陷 ID、关联需求、标题、描述、状态、报告人、处理人、创建时间，以及优先级、严重程度、中文状态、标签、迭代、模块、版本/基线、发布计划、特性、缺陷类型/根源/解决方法/重现规律、各类人员（测试/开发/参与/抄送/修复/验证/审核/关闭人等）、环境（操作系统/平台）、测试方式/阶段/类型、排期/解决/关闭/修改/

  • tapd_list_iterations

    查询 TAPD 项目迭代列表，支持按迭代 ID、名称、状态过滤，以及描述、起止时间、迭代类别、计划应用、创建人、创建/修改/完成时间、锁定人、自定义字段等，并可自定义排序（order）与翻页；用于创建或更新需求时选择 iteration_id

  • tapd_list_stories

    查询 TAPD 需求列表，默认查询当前登录用户负责的需求；传入 owner 可查询指定处理人名下的需求。传入 id 精确查询时不限处理人，可查到已转给他人的需求。传入 workspace_id 时只查该项目；不传 workspace_id 时会聚合处理人参与的所有项目的需求。支持按字段过滤：需求 ID、名称、描述、状态、创建人、处理人、创建时间，以及优先级、标签、版本、模块、迭代、分类、排期/修改/完成时间、父子需求、特性、技术风险、需求类别、发布计划、规模、测试重点、抄送/开发人、来源/类型、工时、自定义字段等，并可自定义排序（order）。返回的状态会附带项目工作流中文名（如「已实现（resolved）」）。【展示约定】向用户呈现结果时，请直接原样输出本工具返回的 Markdown 表格，完整保留「序号」「id」在内的所有列（其中「需求」列已是内嵌超链接的 Markdown 写法，请勿

  • tapd_list_story_changes

    查询 TAPD 需求变更历史和字段级变更详情。story_id、created 与 id 至少提供一个；可按变更人、变更字段、变更类型过滤并自定义排序；include_details=true 时返回 field_changes 变更详情。

  • tapd_list_story_test_cases

    查询指定 TAPD 需求直接关联的所有测试用例，支持按用例名称和状态在本地过滤

  • tapd_list_workspaces

    查询指定用户参与的所有 TAPD 项目（workspace），默认查询当前登录用户。默认过滤掉 category=organization 的公司/组织条目，只返回可用于查询缺陷和需求的具体项目。当用户名下存在多个 workspace_id 时，可先用此工具拿到全部项目 ID；tapd_list_bugs / tapd_list_stories 在不传 workspace_id 时即会跨这些项目聚合查询。

  • tapd_search_users

    按姓名、TAPD nick 或邮箱搜索项目成员。需要更新 bug 处理人前，应先用该工具确认目标处理人的 nick。

  • tapd_upload_bug_attachmentwrite action

    把文件上传到指定缺陷的附件区（支持 png/jpg/mp4 等任意类型，单文件 ≤250MB）。文件内容用 base64 传入（Agent 通常无本地路径）。录屏、视频等应走此工具而非内嵌描述。上传后可用 tapd_get_bugs 在附件区核对。

  • tapd_upload_bug_imagewrite action

    上传图片到 TAPD 并返回 html_code（<img> 片段），用于嵌入缺陷描述。仅支持 png/gif/jpg/jpeg/bmp、单张 ≤5MB。本工具只上传图片、不修改描述：拿到 html_code 后需自行用 tapd_get_bugs 取原描述、拼接后再调 tapd_writeback 的 description（或直接用 tapd_append_bug_description_image 一步完成）。

  • tapd_writeback

    对 TAPD bug 执行一个或多个已确认操作：回填评论、更新标题、更新描述正文、更新状态、更新处理人，以及更新优先级、严重程度、模块、版本、迭代、排期、各类人员、工时、标签等标准字段和自定义字段。各功能相互独立且可自由组合，至少提供 comment、title、description、target_status、target_owners、标准字段或 custom_fields 之一。注意：各动作分多次请求提交、非事务，可能出现部分成功（结果会逐项标明成功/失败）。

  • tapd_writeback_story

    对 TAPD 需求执行一个或多个已确认操作：回填评论、更新描述正文、更新状态、更新处理人，以及更新标题、优先级、迭代、版本、工时、标签等标准字段和自定义字段。各功能相互独立且可自由组合，至少提供 comment、description、target_status、target_owners、标准字段或 custom_fields 之一。注意：各动作分多次请求提交、非事务，可能出现部分成功（结果会逐项标明成功/失败）。

Public scan report

scanner v0.1.9 · 2026-09-25 · same rubric, same numbers if you re-run it

no findings
  • Code scan44 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 74 days ago12/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 78/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How TAPD MCP Server compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
78/100
higher than 57% of 48,255 servers
Tools
18
the typical server has 7
Tools that change things
22%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
195
more than 75% of 12,191 servers with a package

What its tools let an agent do: 14 read · 4 change

Install TAPD MCP Server in Claude Code, Cursor or VS Code

Runs npx -y tapd-mcp-server on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add tapd-mcp-server -- npx -y tapd-mcp-server
Add to Cursor

What the publisher says

From the TAPD MCP Server repository's README, as published. We do not edit it. Read it on GitHub

TAPD MCP Server

把 TAPD 装进你的 IDE 对话框 —— 查需求、评 PRD、修 Bug、回填提测，一句话直达，全程不切窗口。

✨ 核心亮点

  • 🔌 一键安装 —— 一段 npx 配置即用，无需 clone 仓库或装依赖，团队复制即接入。
  • 🐞 Bug / 需求一条龙 —— 查询、读详情、分析定位、回填状态 / 评论 / 处理人，缺陷与需求全流程都在对话里完成（写操作均需你确认）。
  • 🗂️ 跨项目自动聚合 —— 一人负责多个项目？列表查询自动聚合你参与的全部项目，每条结果标注归属，无需逐个切换。
  • 🤖 内置工作流 Prompt —— PRD 研发评估、提测报告、Bug 修复回填三套开箱即用，编排现有工具、读着你的代码给结论。
  • 👥 团队视角 —— 一句话让 Agent 跨成员、跨项目统计全组 bug / 需求（总数、未关闭、超 24h 未关闭、按成员拆分），组长盯进度直接可用（见下方「团队 Bug 统计」示例）。

🚀 快速开始

在 MCP 配置文件中添加以下内容，例如 .cursor/mcp.json 或 .vscode/mcp.json：

{
  "mcpServers": {
    "TAPD MCP": {
      "command": "npx",
      "args": ["-y", "tapd-mcp-server"],
      "env": {
        "TAPD_ACCESS_TOKEN": "你的访问令牌"
      }
    }
  }
}

错误上报与隐私

本工具默认通过 Sentry 上报未捕获的运行时错误（崩溃堆栈、Node 版本、包版本），帮助维护者发现和修复问题。已做脱敏处理：

  • ✅ 上报：错误堆栈、HTTP 请求的域名与路径、响应状态码
  • ❌ 不上报：TAPDACCESSTOKEN（走请求头，不进任何上报字段）、URL 查询参数（workspace_id、检索关键词等业务数据）、console 日志内容
  • 正常的工具调用与查询结果不会触发任何上报

如需完全关闭，在 MCP 配置的 env 中设置 TAPDMCPSENTRY_DSN 为空字符串即可：

"env": { "TAPD_MCP_SENTRY_DSN": "" }

💡 使用示例

1. 团队 Bug 统计

统计我们组每个成员名下的 bug 数量，重点关注今日新增、超 24h 未修复、bug 存留超 72h，图表展示

Agent 会先用 tapdsearchusers 确认各成员 nick，再用 tapdlistbugs（跨项目聚合）逐个统计，汇总出全组视图：每人的未关闭、今日新增、超 24h / 72h、挂起等数量，并可按成员拆分明细。配合客户端的可视化能力（如 Cursor Canvas），还能直接生成下面这样的看板，组长盯进度一目了然。

这是一个由 Agent 编排多个 MCP 工具完成的使用场景，并非单个内置工具；统计维度与可视化形式由你的指令和客户端能力决定。

2. 查询我名下的需求和 Bug

列出我名下待处理的需求和 bug

Agent 跨项目聚合查询你负责的需求与缺陷，返回带内嵌超链接的 Markdown 表格——名称即链接、点击直达 TAPD，并标注每条所属项目。可继续按状态、创建时间、关联需求等过滤，或指定某个项目 ID 只查该项目。

3. 批量判断服务端归因并追加处理人

分析我名下待处理的 bug，哪些更像是服务端原因，并在处理人里添加服务端同学亚勇

Agent 会先查询 bug 详情，再根据现象、接口返回、复现步骤等信息判断疑似服务端问题。更新处理人前会先用 tapdsearchusers 确认成员身份，最后经你确认后再写回 TAPD。

4. Bug 批量修复并回填

帮我修复 123456、123457，结合代码定位并给出修改方案

Agent 跨项目定位各 bug、拉取完整上下文（描述、复现、评论、附件、图片），结合当前代码库给出问题定位与修改建议（改码需你确认）；修复后用内置 Prompt tapdbugfix_writeback 生成回填草稿，确认后把状态改为已解决并写入评论，不会主动更新处理人。

5. 需求宣讲前研发评估

使用 tapdprdanalysis 分析需求 123456，生成需求宣讲前研发评估报告

支持 MCP Prompts 的客户端会自动获得 tapdprdanalysis。Agent 获取需求详情，按需查询需求变更、关联测试用例和关联 bug，再阅读当前代码库定位相关路由、页面、组件、接口、状态管理、数据模型、权限、埋点和配置，结合代码现状给出研发视角的判断（结论先行、不复述 PRD，写操作均需你确认）。

报告按固定模板输出，便于宣讲前快速过审：

  • 结论 —— 需求目标、改动范围、最大风险、必须确认；
  • 技术判断 —— 相关代码、实现方案、接口 / 数据 / 权限；
  • 风险与依赖 —— 主要风险、外部依赖、漏洞 / 异常场景；
  • 测试建议 —— 验收路径、边界 / 回归；
  • 待确认问题 —— 最多 3 条，不确定项标注「需要确认」，不臆测、不凑数。

6. 提测准入判断并生成提测文档

使用 tapdtestdoc 生成提测文档，测试环境是 https://example.com/checkout.html

支持 MCP Prompts 的客户端会自动获得 tapdtestdoc，只读代码、不改 TAPD，分两阶段：

  1. 提测准入判断 —— 自动对照需求的 PRD 用例、验收要点和未关闭缺陷，判断本次改动是否达标。
  2. 生成提测文档 —— 达标或你确认后，把代码改动翻译成「本次提测」与「测试重点」，写入项目根目录 提测文档.md。

两种典型结果：

  • 准入通过 —— 直接生成提测文档，含 测试环境 / 本次提测 / 测试重点 / 已知问题 四段。
  • 准入不达标 —— 逐条列出差距，请你三选一：A 继续提测并记为已知问题 / B 继续提测忽略风险 / C 终止提测；未决策前不生成文档。

🧰 能力总览

工具（18）

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

TAPD MCP Server: common questions

Is TAPD MCP Server safe?
Mostly: it is graded B (78/100). Read the TAPD MCP Server safety report
How do I install TAPD MCP Server?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does TAPD MCP Server need an API key?
Yes. The registry entry asks for TAPD_ACCESS_TOKEN.
Is TAPD MCP Server maintained?
The last commit was 113 days ago (2026-07-14). The latest release is v1.0.8.
How does TAPD MCP Server compare with other MCP servers?
safety score 78/100 (higher than 57% of 48,255 servers); tools 18 (the typical server has 7); tools that change things 22% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.