@dannyvan/zentao-mcp 0.1.0 → 0.1.2
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 +12 -0
- package/dist/cli.js +17 -0
- package/dist/cli.js.map +1 -1
- package/dist/index.js +3 -2
- package/dist/index.js.map +1 -1
- package/dist/skill.d.ts +4 -0
- package/dist/skill.js +16 -0
- package/dist/skill.js.map +1 -0
- package/package.json +3 -2
- package/skills/zentao-mcp/SKILL.md +60 -0
package/README.md
CHANGED
|
@@ -2,12 +2,23 @@
|
|
|
2
2
|
|
|
3
3
|
禅道（ZenTao）**MCP + CLI**，直连 REST API（`api.php/v1`）。只做 Bug：读详情 / 列表 / 搜索，写评论与状态流转。写操作默认 dry-run。
|
|
4
4
|
|
|
5
|
+
不必 clone。MCP 启动时会带上用法（`instructions`）。
|
|
6
|
+
|
|
5
7
|
## 安装
|
|
6
8
|
|
|
9
|
+
MCP：
|
|
10
|
+
|
|
7
11
|
```bash
|
|
8
12
|
npx -y @dannyvan/zentao-mcp
|
|
9
13
|
```
|
|
10
14
|
|
|
15
|
+
把 skill 装到本机 agent（识别已安装的工具，并询问装哪几家，与得到大脑 `npx skills add iswalle/getnote-cli` 相同）：
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
npx -y @dannyvan/zentao-mcp install-skill
|
|
19
|
+
# 等同于：npx skills add dannyvan/zentao-mcp -g
|
|
20
|
+
```
|
|
21
|
+
|
|
11
22
|
发布到 npm 之前，可在本仓 `npm install && npm run build` 后用 `node dist/index.js`。
|
|
12
23
|
|
|
13
24
|
## 认证
|
|
@@ -46,6 +57,7 @@ npx -y @dannyvan/zentao-mcp
|
|
|
46
57
|
## CLI
|
|
47
58
|
|
|
48
59
|
```bash
|
|
60
|
+
npx -y @dannyvan/zentao-mcp skill
|
|
49
61
|
npx -y @dannyvan/zentao-mcp help
|
|
50
62
|
npx -y @dannyvan/zentao-mcp get-bug 123
|
|
51
63
|
npx -y @dannyvan/zentao-mcp list-bugs --product 1 --limit 50
|
package/dist/cli.js
CHANGED
|
@@ -4,12 +4,16 @@
|
|
|
4
4
|
* 写操作默认 dry-run，必须显式 --confirm 才真正提交。
|
|
5
5
|
* 输出一律 JSON；出错时 JSON 写 stderr，退出码非 0。
|
|
6
6
|
*/
|
|
7
|
+
import { spawnSync } from "node:child_process";
|
|
7
8
|
import { clientFromEnv, formatZentaoError } from "./zentao-client.js";
|
|
9
|
+
import { skillInstructions } from "./skill.js";
|
|
8
10
|
const USAGE = `zentao-mcp —— 禅道 CLI / MCP 双门面
|
|
9
11
|
|
|
10
12
|
用法:
|
|
11
13
|
zentao-mcp 以 MCP server 启动（stdio，默认）
|
|
12
14
|
zentao-mcp serve 同上，显式写法
|
|
15
|
+
zentao-mcp skill 打印给 agent 的用法（无需认证）
|
|
16
|
+
zentao-mcp install-skill 装到本机已检测到的 agent（会询问装哪几家）
|
|
13
17
|
zentao-mcp <命令> [参数] CLI 模式
|
|
14
18
|
|
|
15
19
|
读命令（无副作用）:
|
|
@@ -84,12 +88,25 @@ async function highRisk(client, id, confirm, preview, exec) {
|
|
|
84
88
|
}
|
|
85
89
|
out({ ok: true, dryRun: false, result: await exec() });
|
|
86
90
|
}
|
|
91
|
+
/** 与得到大脑相同：交给 `npx skills add`，由它识别本机 agent 并询问装哪几家。 */
|
|
92
|
+
function installSkill(extra) {
|
|
93
|
+
const r = spawnSync("npx", ["-y", "skills", "add", "dannyvan/zentao-mcp", "-g", ...extra], { stdio: "inherit" });
|
|
94
|
+
process.exit(r.status ?? 1);
|
|
95
|
+
}
|
|
87
96
|
export async function runCli(argv) {
|
|
88
97
|
const [command, ...rest] = argv;
|
|
89
98
|
if (!command || command === "help" || command === "--help" || command === "-h") {
|
|
90
99
|
console.log(USAGE);
|
|
91
100
|
return;
|
|
92
101
|
}
|
|
102
|
+
if (command === "skill") {
|
|
103
|
+
console.log(skillInstructions());
|
|
104
|
+
return;
|
|
105
|
+
}
|
|
106
|
+
if (command === "install-skill") {
|
|
107
|
+
installSkill(rest);
|
|
108
|
+
return;
|
|
109
|
+
}
|
|
93
110
|
const { positional, flags } = parseArgs(rest);
|
|
94
111
|
const confirm = flags.confirm === true || flags.confirm === "true";
|
|
95
112
|
const client = clientFromEnv();
|
package/dist/cli.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAgB,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;
|
|
1
|
+
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
|
package/dist/index.js
CHANGED
|
@@ -18,6 +18,7 @@ import { clientFromEnv } from "./zentao-client.js";
|
|
|
18
18
|
import { registerReadTools } from "./tools/read.js";
|
|
19
19
|
import { registerWriteTools } from "./tools/write.js";
|
|
20
20
|
import { runCli } from "./cli.js";
|
|
21
|
+
import { skillInstructions } from "./skill.js";
|
|
21
22
|
function assertUrl() {
|
|
22
23
|
if (!process.env.ZENTAO_URL?.trim()) {
|
|
23
24
|
console.error("ERROR: 缺少 ZENTAO_URL。请设置为禅道地址，例如 https://example.com/zentao");
|
|
@@ -35,7 +36,7 @@ function assertAuth() {
|
|
|
35
36
|
async function serve() {
|
|
36
37
|
assertUrl();
|
|
37
38
|
assertAuth();
|
|
38
|
-
const server = new McpServer({ name: "zentao-mcp", version: "0.1.
|
|
39
|
+
const server = new McpServer({ name: "zentao-mcp", version: "0.1.2" }, { instructions: skillInstructions() });
|
|
39
40
|
const client = clientFromEnv();
|
|
40
41
|
registerReadTools(server, client);
|
|
41
42
|
registerWriteTools(server, client);
|
|
@@ -48,7 +49,7 @@ async function main() {
|
|
|
48
49
|
await serve();
|
|
49
50
|
return;
|
|
50
51
|
}
|
|
51
|
-
const needsAuth = !["help", "--help", "-h"].includes(argv[0]);
|
|
52
|
+
const needsAuth = !["help", "--help", "-h", "skill", "install-skill"].includes(argv[0]);
|
|
52
53
|
if (needsAuth) {
|
|
53
54
|
assertUrl();
|
|
54
55
|
assertAuth();
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,SAAS,SAAS;IAChB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;QACpC,OAAO,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC;QAC7E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,UAAU;IACjB,MAAM,QAAQ,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IAC5C,MAAM,WAAW,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAClF,IAAI,CAAC,QAAQ,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CACX,sEAAsE,CACvE,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,KAAK;IAClB,SAAS,EAAE,CAAC;IACZ,UAAU,EAAE,CAAC;IACb,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,EACxC,EAAE,YAAY,EAAE,iBAAiB,EAAE,EAAE,CACtC,CAAC;IACF,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;IACjD,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;AAChD,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;QAC7C,MAAM,KAAK,EAAE,CAAC;QACd,OAAO;IACT,CAAC;IACD,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACxF,IAAI,SAAS,EAAE,CAAC;QACd,SAAS,EAAE,CAAC;QACZ,UAAU,EAAE,CAAC;IACf,CAAC;IACD,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
|
package/dist/skill.d.ts
ADDED
package/dist/skill.js
ADDED
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import { readFileSync } from "node:fs";
|
|
2
|
+
import { dirname, join } from "node:path";
|
|
3
|
+
import { fileURLToPath } from "node:url";
|
|
4
|
+
function skillPath() {
|
|
5
|
+
const here = dirname(fileURLToPath(import.meta.url));
|
|
6
|
+
return join(here, "..", "skills", "zentao-mcp", "SKILL.md");
|
|
7
|
+
}
|
|
8
|
+
/** 仓内 / npm 包里那份 skill 全文。 */
|
|
9
|
+
export function loadSkillMarkdown() {
|
|
10
|
+
return readFileSync(skillPath(), "utf8");
|
|
11
|
+
}
|
|
12
|
+
/** 去掉 frontmatter，给 MCP instructions / `zentao-mcp skill`。 */
|
|
13
|
+
export function skillInstructions() {
|
|
14
|
+
return loadSkillMarkdown().replace(/^---[\s\S]*?---\s*/, "").trim();
|
|
15
|
+
}
|
|
16
|
+
//# sourceMappingURL=skill.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"skill.js","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,SAAS,SAAS;IAChB,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,OAAO,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;AAC9D,CAAC;AAED,8BAA8B;AAC9B,MAAM,UAAU,iBAAiB;IAC/B,OAAO,YAAY,CAAC,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,iBAAiB;IAC/B,OAAO,iBAAiB,EAAE,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACtE,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@dannyvan/zentao-mcp",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.2",
|
|
4
4
|
"description": "禅道 MCP + CLI，直连 REST API v1。只做 Bug，写操作默认 dry-run。",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -9,7 +9,8 @@
|
|
|
9
9
|
},
|
|
10
10
|
"files": [
|
|
11
11
|
"dist",
|
|
12
|
-
"README.md"
|
|
12
|
+
"README.md",
|
|
13
|
+
"skills"
|
|
13
14
|
],
|
|
14
15
|
"publishConfig": {
|
|
15
16
|
"access": "public"
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: zentao-mcp
|
|
3
|
+
description: >-
|
|
4
|
+
用 @dannyvan/zentao-mcp 查或改禅道 Bug（MCP / CLI / npx）。
|
|
5
|
+
用户提到禅道、Zentao、查 bug、指派/解决/关闭 bug、配 zentao MCP 时使用。
|
|
6
|
+
不要用官方 zentao-cli。
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# 禅道 Bug（@dannyvan/zentao-mcp）
|
|
10
|
+
|
|
11
|
+
只做 Bug。走本包的 MCP 或 CLI，**不要**装官方 `zentao-cli`。不必 clone 本仓。
|
|
12
|
+
|
|
13
|
+
## 启动
|
|
14
|
+
|
|
15
|
+
MCP（`npx` 即可）：
|
|
16
|
+
|
|
17
|
+
```json
|
|
18
|
+
{
|
|
19
|
+
"mcpServers": {
|
|
20
|
+
"zentao": {
|
|
21
|
+
"command": "npx",
|
|
22
|
+
"args": ["-y", "@dannyvan/zentao-mcp"],
|
|
23
|
+
"env": {
|
|
24
|
+
"ZENTAO_URL": "https://<禅道域名>/zentao",
|
|
25
|
+
"ZENTAO_ACCOUNT": "<账号>",
|
|
26
|
+
"ZENTAO_PASSWORD": "<密码>"
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
CLI：`npx -y @dannyvan/zentao-mcp <命令>`。无参数或 `serve` 是 MCP stdio。
|
|
34
|
+
|
|
35
|
+
`ZENTAO_URL` 必填。认证：`ZENTAO_ACCOUNT` + `ZENTAO_PASSWORD`，或 `ZENTAO_TOKEN`。凭证只放 MCP `env` 或环境变量，不写进仓库。
|
|
36
|
+
|
|
37
|
+
## 读
|
|
38
|
+
|
|
39
|
+
- `zentao_get_bug`：按 ID，默认含 steps
|
|
40
|
+
- `zentao_list_bugs`：按产品分页。`total` 可能不准，以实际列出为准
|
|
41
|
+
- `zentao_search_bugs`：当前产品里扫标题 / steps，范围受 `scan_limit`
|
|
42
|
+
|
|
43
|
+
CLI：`get-bug` / `list-bugs --product` / `search-bugs --product --keyword`
|
|
44
|
+
|
|
45
|
+
## 写
|
|
46
|
+
|
|
47
|
+
高风险（resolve / close / activate / confirm / assign）**默认 dry-run**：
|
|
48
|
+
|
|
49
|
+
- MCP：先不带 `confirm` 看预览，用户确认后再 `confirm=true`
|
|
50
|
+
- CLI：先不带 `--confirm`，确认后再加
|
|
51
|
+
|
|
52
|
+
`zentao_comment_bug` 会报错：禅道 v1 REST 没有独立备注。让用户去网页加。
|
|
53
|
+
|
|
54
|
+
批量改状态必须**串行逐条**，不要并行。写操作在禅道可见。
|
|
55
|
+
|
|
56
|
+
## 禁止
|
|
57
|
+
|
|
58
|
+
- 不装、不调用官方 `zentao-cli`
|
|
59
|
+
- 不编造默认禅道地址
|
|
60
|
+
- 不把账号密码写进会提交的文件
|