@xihe-lab/tapd-mcp-server 1.0.1 → 1.0.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +22 -35
- package/package.json +5 -1
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[](https://github.com/xihe-lab/tapd-mcp-server/actions/workflows/ci.yml)
|
|
4
4
|
[](https://www.npmjs.com/package/@xihe-lab/tapd-mcp-server)
|
|
5
|
-
[](https://github.com/xihe-lab/tapd-mcp-server/blob/main/LICENSE)
|
|
6
6
|
[](https://www.npmjs.com/package/@xihe-lab/tapd-mcp-server)
|
|
7
7
|
|
|
8
8
|
通过 [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) 将腾讯 TAPD 接入 Claude、Cursor 等 AI 助手，用自然语言管理需求、缺陷、任务和迭代。
|
|
@@ -15,49 +15,29 @@
|
|
|
15
15
|
|
|
16
16
|
### 2. 配置 MCP 客户端
|
|
17
17
|
|
|
18
|
-
需要 Node.js >= 18.0.0
|
|
18
|
+
需要 Node.js >= 18.0.0。
|
|
19
19
|
|
|
20
|
-
####
|
|
20
|
+
#### 方式一：一键安装命令
|
|
21
21
|
|
|
22
|
-
|
|
22
|
+
注意替换 `your_access_token` 和 `your_workspace_id`：
|
|
23
23
|
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
"args": ["-y", "@xihe-lab/tapd-mcp-server"],
|
|
30
|
-
"env": {
|
|
31
|
-
"TAPD_ACCESS_TOKEN": "your_access_token",
|
|
32
|
-
"TAPD_DEFAULT_WORKSPACE_ID": "your_workspace_id"
|
|
33
|
-
}
|
|
34
|
-
}
|
|
35
|
-
}
|
|
36
|
-
}
|
|
24
|
+
```bash
|
|
25
|
+
claude mcp add -s user tapd \
|
|
26
|
+
--env TAPD_ACCESS_TOKEN=your_access_token \
|
|
27
|
+
--env TAPD_DEFAULT_WORKSPACE_ID=your_workspace_id \
|
|
28
|
+
-- npx -y "@xihe-lab/tapd-mcp-server"
|
|
37
29
|
```
|
|
38
30
|
|
|
39
|
-
|
|
31
|
+
若忘记替换凭证，重新安装前需先卸载旧的配置：
|
|
40
32
|
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
{
|
|
45
|
-
"mcpServers": {
|
|
46
|
-
"tapd": {
|
|
47
|
-
"command": "npx",
|
|
48
|
-
"args": ["-y", "@xihe-lab/tapd-mcp-server"],
|
|
49
|
-
"env": {
|
|
50
|
-
"TAPD_ACCESS_TOKEN": "your_access_token",
|
|
51
|
-
"TAPD_DEFAULT_WORKSPACE_ID": "your_workspace_id"
|
|
52
|
-
}
|
|
53
|
-
}
|
|
54
|
-
}
|
|
55
|
-
}
|
|
33
|
+
```bash
|
|
34
|
+
claude mcp list
|
|
35
|
+
claude mcp remove tapd
|
|
56
36
|
```
|
|
57
37
|
|
|
58
|
-
####
|
|
38
|
+
#### 方式二：手动配置
|
|
59
39
|
|
|
60
|
-
|
|
40
|
+
编辑 Claude Code 的配置文件（用户目录下 `.claude.json`）：
|
|
61
41
|
|
|
62
42
|
```json
|
|
63
43
|
{
|
|
@@ -74,6 +54,13 @@
|
|
|
74
54
|
}
|
|
75
55
|
```
|
|
76
56
|
|
|
57
|
+
其他客户端配置方式：
|
|
58
|
+
|
|
59
|
+
- **Claude Desktop**：编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`（macOS）
|
|
60
|
+
- **Cursor / VS Code**：在项目根目录创建 `.cursor/mcp.json` 或 `.vscode/mcp.json`
|
|
61
|
+
|
|
62
|
+
配置格式与上方相同。
|
|
63
|
+
|
|
77
64
|
### 3. 开始使用
|
|
78
65
|
|
|
79
66
|
配置完成后重启客户端，直接用自然语言与 AI 助手对话：
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@xihe-lab/tapd-mcp-server",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.3",
|
|
4
4
|
"description": "MCP server for TAPD project management API, enabling AI assistants to manage stories, bugs, tasks, iterations and more via natural language",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -37,6 +37,10 @@
|
|
|
37
37
|
"engines": {
|
|
38
38
|
"node": ">=18.0.0"
|
|
39
39
|
},
|
|
40
|
+
"publishConfig": {
|
|
41
|
+
"access": "public",
|
|
42
|
+
"registry": "https://registry.npmjs.org"
|
|
43
|
+
},
|
|
40
44
|
"files": [
|
|
41
45
|
"dist",
|
|
42
46
|
"README.md",
|