TAPD MCP Server

本地服务

github.com生产力

代码仓库访问官网

关于 TAPD MCP Server

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

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "scizuixiangsis-tapd": {
      "command": "npx",
      "args": [
        "-y",
        "tapd-mcp-server"
      ],
      "env": {
        "TAPD_ACCESS_TOKEN": "<TAPD_ACCESS_TOKEN>"
      }
    }
  }
}

启动命令npx -y tapd-mcp-server

需要配置的环境变量

TAPD_ACCESS_TOKEN密钥TAPD 个人访问令牌

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmtapd-mcp-server1.0.2stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
id	string	否	缺陷 ID，TAPD 支持多 ID 查询。传入 id 时默认跳过处理人过滤（除非同时显式传入 current_owner），以便查到已转出的缺陷
page	integer	否	页码，默认 1。聚合查询（不传 workspace_id）时按每个项目分别分页，并非跨项目全局分页
limit	integer	否	返回数量上限，默认 30，最大 200；聚合查询时为每个项目的上限
title	string	否	缺陷标题，TAPD 支持模糊匹配
status	string	否	缺陷状态，TAPD 支持枚举查询和不等于查询
created	string	否	创建时间，TAPD 支持时间查询
reporter	string	否	报告人，TAPD 支持多用户查询
story_id	string	否	关联需求 ID，返回该需求的关联缺陷；默认不按当前登录用户过滤（与按 id 精确查询一致，可查到他人名下的关联缺陷），仅在显式传入 current_owner 时按该处理人取交集。与 id 参数同时使用时取交集；该过滤需要具体项目，必须同时传入 workspace_id
description	string	否	缺陷详细描述，TAPD 支持模糊匹配
workspace_id	string	否	TAPD 项目 ID。传入则只查该项目；不传则聚合处理人参与的所有项目的缺陷。可先用 tapd_list_workspaces 查看会覆盖哪些项目
current_owner	string	否	单个处理人 TAPD nick，不传默认查询当前登录用户负责的缺陷；传入则查询指定处理人名下的缺陷，建议先用 tapd_search_users 确认 nick