@zzp123/mcp-zentao 1.18.2 → 1.18.4

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.
Files changed (11) hide show
  1. package/CHANGELOG.md +48 -0
  2. package/README.md +39 -0
  3. package/dist/api/zentaoApi.js +1 -266
  4. package/dist/config.js +1 -1
  5. package/dist/index-dev.js +4 -23
  6. package/dist/index-pm.js +70 -85
  7. package/dist/index-qa.js +1 -23
  8. package/dist/index.js +74 -130
  9. package/dist/mcpHelpers.d.ts +13 -0
  10. package/dist/mcpHelpers.js +24 -0
  11. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -5,6 +5,54 @@ All notable changes to this project will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
+ ## [1.18.4] - 2025-01-17
9
+
10
+ ### Fixed
11
+ - **修复 MCP stdio 协议污染问题** 🔧
12
+ - 删除所有 `console.log` / `console.error` / `console.warn` 语句（240+ 处）
13
+ - MCP stdio 服务器的 stdout 仅用于 JSON-RPC 通信，任何日志输出都会破坏协议
14
+ - 保留 2 处关键错误输出到 stderr（配置加载失败、MCP 启动失败）
15
+ - 错误处理通过 `throw Error` 自动传递给 MCP 客户端
16
+
17
+ ### Changed
18
+ - 所有调试日志已移除，不再污染 stdout
19
+ - MCP 服务器启动失败时输出到 stderr 并正确退出
20
+ - 配置文件加载失败时输出到 stderr
21
+
22
+ ### Impact
23
+ - **协议兼容性**: 完全符合 MCP stdio 协议规范
24
+ - **稳定性**: 避免因日志输出导致的协议解析失败
25
+ - **性能**: 减少 I/O 开销，提升响应速度
26
+ - **代码量**: 删除约 240 行日志代码
27
+
28
+ ### Technical
29
+ - 清理 `src/api/zentaoApi.ts` 中的 176 处日志
30
+ - 清理 `src/index.ts` 中的 91 处日志
31
+ - 清理 `src/index-dev.ts` 中的 38 处日志
32
+ - 清理 `src/index-pm.ts` 中的 39 处日志
33
+ - 清理 `src/index-qa.ts` 中的 26 处日志
34
+ - 优化 `src/config.ts` 的错误输出到 stderr
35
+ - 保留关键启动错误处理，输出格式：`[FATAL]` / `[ERROR]`
36
+
37
+ ### Migration
38
+ - 无需用户操作，升级后自动生效
39
+ - 错误信息会通过 MCP 客户端（Claude Desktop）正确显示
40
+ - 开发调试推荐使用官方 MCP Inspector 工具
41
+
42
+ ## [1.18.3] - 2025-01-12
43
+
44
+ ### Fixed
45
+ - **修复MCP协议兼容性问题** 🔧
46
+ - 修复 `changeStory` 和 `changeRequirement` 工具的参数类型错误
47
+ - 移除 `z.union([z.object({...}), z.string()])` 改为纯对象类型
48
+ - 解决 "Expected object, received string" 错误
49
+ - 同时修复完整版和产品经理版本
50
+
51
+ ### Technical
52
+ - 更新 `src/index.ts` 中的 `changeStory` 和 `changeRequirement` 工具定义
53
+ - 更新 `src/index-pm.ts` 中的 `changeStory` 工具定义
54
+ - 符合MCP协议规范，所有参数必须是对象类型
55
+
8
56
  ## [1.17.6] - 2025-11-10
9
57
 
10
58
  ### Changed
package/README.md CHANGED
@@ -79,6 +79,45 @@ npm install @zzp123/mcp-zentao -g
79
79
  - ✅ 文件上传
80
80
  </details>
81
81
 
82
+ ## 🎯 Claude Code Skills
83
+
84
+ **新功能！** 现在提供 Claude Code Skills 支持，让你通过自然语言更便捷地使用禅道功能。
85
+
86
+ ### 什么是 Skills？
87
+
88
+ Skills 是 Claude Code 的功能扩展，通过它你可以：
89
+ - 用自然语言描述需求，无需记住命令
90
+ - 智能化的任务管理和状态更新
91
+ - 更友好的交互体验
92
+
93
+ ### 可用的 Skills
94
+
95
+ 目前提供以下 Skills：
96
+
97
+ | Skill | 适用角色 | 功能 | 文档 |
98
+ |-------|---------|-----|------|
99
+ | **zentao-dev** | 开发工程师 | 任务管理、Bug解决、项目管理 | [文档](./.claude/skills/zentao-dev/) |
100
+
101
+ ### 如何使用 Skills？
102
+
103
+ 1. **安装 MCP 服务器**（如果还没安装）：
104
+ ```bash
105
+ npm install -g @zzp123/mcp-zentao
106
+ ```
107
+
108
+ 2. **配置 Claude Desktop**（参考下方 MCP 配置）
109
+
110
+ 3. **在 Claude Code 中使用**：
111
+ ```
112
+ 你：查看我今天的任务
113
+ AI：[显示任务列表]
114
+
115
+ 你：开始处理任务 #123
116
+ AI：✓ 任务已更新为"进行中"状态
117
+ ```
118
+
119
+ 详细使用指南请查看 [Skills 文档](./.claude/skills/zentao-dev/README.md)
120
+
82
121
  ## 📋 版本历史
83
122
 
84
123
  查看完整的版本更新历史，请访问 [CHANGELOG.md](./CHANGELOG.md)