TAPD MCP Server

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_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 至少提供一个，支持按变更人、变更字段和分页过滤。状态变更会附带项目工作流中文名（如「接受/处理（in_progress） => 已解决（resolved）」）。

• tapd_list_bugs

  查询 TAPD bug 列表，默认查询当前登录用户负责的缺陷；传入 current_owner 可查询指定处理人名下的缺陷。传入 id 或 story_id 时不限处理人（story_id 返回该需求全部处理人名下的关联缺陷），可查到已转给他人的缺陷；显式传入 current_owner 时再按该处理人取交集。传入 workspace_id 时只查该项目；不传 workspace_id 时会聚合处理人参与的所有项目的缺陷（按 story_id 过滤时仍需具体项目）。支持按字段过滤：缺陷 ID、关联需求、缺陷标题、缺陷详细描述、缺陷状态、报告人、处理人、创建时间。返回的状态会附带项目工作流中文名（如「已解决（resolved）」）。【展示约定】向用户呈现结果时，请直接原样输出本工具返回的 Markdown 表格，完整保留「序号」「id」在内的所有列（其中「缺陷」列已是内嵌超链接的 Markd

• tapd_list_iterations

  查询 TAPD 项目迭代列表，支持按迭代 ID、名称、状态过滤；用于创建或更新需求时选择 iteration_id

• tapd_list_stories

  查询 TAPD 需求列表，默认查询当前登录用户负责的需求；传入 owner 可查询指定处理人名下的需求。传入 id 精确查询时不限处理人，可查到已转给他人的需求。传入 workspace_id 时只查该项目；不传 workspace_id 时会聚合处理人参与的所有项目的需求。支持按字段过滤：需求 ID、需求名称、需求详细描述、需求状态、创建人、处理人、创建时间。返回的状态会附带项目工作流中文名（如「已实现（resolved）」）。【展示约定】向用户呈现结果时，请直接原样输出本工具返回的 Markdown 表格，完整保留「序号」「id」在内的所有列（其中「需求」列已是内嵌超链接的 Markdown 写法，请勿拆成裸 URL、改成纯文本或删除链接），不要裁剪列、改列名或将表格拆分重排；如需补充分类或小结，可在表格之外另起段落，但表格本身保持原样。

• tapd_list_story_changes

  查询 TAPD 需求变更历史和字段级变更详情。story_id 与 created 至少提供一个；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 之一。

• tapd_writeback_story

  对 TAPD 需求执行一个或多个已确认操作：回填评论、更新描述正文、更新状态、更新处理人。各功能相互独立且可自由组合，至少提供 comment、description、target_status、target_owners 之一。

• Code scan20 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
• Maintenancerepository not readable: repo not found3/15
• Maintainer identityno repository or website to verify2/10

Safety score

55/100

higher than 10% of 48,255 servers

Tools

17

the typical server has 7

Tools that change things

24%

typical: 0%. Fewer write tools means less an agent can break

Downloads a week

199

more than 75% of 12,191 servers with a package

TAPD MCP Server: common questions

Is TAPD MCP Server safe?

With care: it is graded C, so read the findings first (55/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 latest release is v1.0.2.

How does TAPD MCP Server compare with other MCP servers?

safety score 55/100 (higher than 10% of 48,255 servers); tools 17 (the typical server has 7); tools that change things 24% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.