@maxenlin/mcp-zentao-11-3 1.0.0-patch.1

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024 maxenlin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,254 @@
+# @maxenlin/mcp-zentao-11-3
+
+禅道 11.3 Legacy 版 MCP 服务器，专为 Cursor IDE 设计，只支持旧版 Session API。
+
+## ✨ 特性
+
+- ✅ **纯 Legacy API** - 只支持禅道 11.x 版本的 Session API
+- ✅ **功能完整** - 支持任务、Bug、需求、测试用例等完整功能
+- ✅ **AI 编程优化** - 提供完整开发上下文、格式化输出、智能摘要等功能
+- ✅ **开箱即用** - 配置简单，专注核心功能
+
+## 📋 系统要求
+
+- **Node.js**: >= 18.0.0（推荐使用 LTS 版本）
+
+## 📦 安装
+
+### 方法 1：使用 npx（推荐）
+
+在 Cursor IDE 配置文件中添加：
+
+```json
+{
+  "mcpServers": {
+    "zentao-11-3": {
+      "command": "npx",
+      "args": ["-y", "@maxenlin/mcp-zentao-11-3"],
+      "env": {
+        "ZENTAO_URL": "http://your-zentao-url/zentao",
+        "ZENTAO_USERNAME": "your-username",
+        "ZENTAO_PASSWORD": "your-password"
+      }
+    }
+  }
+}
+```
+
+### 方法 2：本地安装
+
+```bash
+npm install -g @maxenlin/mcp-zentao-11-3
+```
+
+然后在 Cursor IDE 配置文件中添加：
+
+```json
+{
+  "mcpServers": {
+    "zentao-11-3": {
+      "command": "mcp-zentao-11-3",
+      "args": [],
+      "env": {
+        "ZENTAO_URL": "http://your-zentao-url/zentao",
+        "ZENTAO_USERNAME": "your-username",
+        "ZENTAO_PASSWORD": "your-password"
+      }
+    }
+  }
+}
+```
+
+## ⚙️ 配置
+
+### 方法 1：在 Cursor 配置中直接设置（推荐）
+
+在 Cursor IDE 的 MCP 配置文件中，直接在 `env` 字段中填入配置：
+
+```json
+{
+  "mcpServers": {
+    "zentao-11-3": {
+      "command": "mcp-zentao-11-3",
+      "args": [],
+      "env": {
+        "ZENTAO_URL": "http://your-zentao-url/zentao",
+        "ZENTAO_USERNAME": "your-username",
+        "ZENTAO_PASSWORD": "your-password"
+      }
+    }
+  }
+}
+```
+
+**配置说明：**
+- `ZENTAO_URL`: 禅道服务器地址（必须包含 `/zentao` 路径）
+- `ZENTAO_USERNAME`: 禅道用户名
+- `ZENTAO_PASSWORD`: 禅道密码
+
+### 方法 2：使用配置文件（备选）
+
+如果不想在 Cursor 配置中直接填写密码，可以创建配置文件：
+
+**Windows:**
+```
+C:\Users\你的用户名\.zentao\config.json
+```
+
+**macOS/Linux:**
+```
+~/.zentao/config.json
+```
+
+配置文件内容：
+
+```json
+{
+  "url": "http://your-zentao-url/zentao",
+  "username": "your-username",
+  "password": "your-password",
+  "apiVersion": "legacy"
+}
+```
+
+**注意：** 环境变量配置优先于配置文件。如果同时设置了环境变量和配置文件，将使用环境变量中的配置。
+
+## 🚀 使用
+
+配置完成后，重启 Cursor IDE 即可使用。
+
+### 基础功能
+
+```
+获取我的任务
+获取我的Bug
+获取所有产品列表
+获取产品230的需求列表
+查看需求2508的详情
+```
+
+### 关联关系查询
+
+```
+获取需求2508关联的所有Bug
+查看Bug 20692关联的需求
+```
+
+### 批量操作
+
+```
+批量更新任务状态为进行中
+批量解决Bug，标记为已修复
+```
+
+### 数据统计
+
+```
+查看我的任务统计
+查看我的Bug统计
+```
+
+### AI 编程辅助
+
+```
+获取需求2508的完整开发上下文（包含关联的Bug和测试用例）
+生成需求2508的Markdown摘要
+生成Bug 20692的Markdown摘要
+格式化任务123为Markdown
+```
+
+### 智能分析
+
+```
+分析需求2508的复杂度
+分析Bug 20692的优先级
+分析任务123的工作量
+```
+
+### 代码生成提示
+
+```
+根据需求2508生成代码框架提示
+根据Bug 20692生成测试用例提示
+生成需求2508的代码审查检查清单
+```
+
+## 📋 可用工具
+
+### 配置管理
+- `initZentao` - 初始化禅道连接
+- `getConfig` - 查看配置信息
+
+### 任务管理
+- `getMyTasks` - 获取我的任务列表
+- `getTaskDetail` - 获取任务详情
+- `updateTask` - 更新任务
+- `finishTask` - 完成任务
+
+### Bug 管理
+- `getMyBugs` - 获取我的Bug列表
+- `getBugDetail` - 获取Bug详情
+- `resolveBug` - 解决Bug
+
+### 产品管理
+- `getProducts` - 获取产品列表
+
+### 需求管理
+- `getProductStories` - 获取产品的需求列表
+- `getStoryDetail` - 获取需求详情
+- `searchStories` - 搜索需求
+- `searchStoriesByProductName` - 按产品名称搜索需求
+
+### 测试用例管理
+- `getProductTestCases` - 获取产品的测试用例
+- `getTestCaseDetail` - 获取测试用例详情
+- `createTestCase` - 创建测试用例
+- `getStoryTestCases` - 获取需求的测试用例
+
+### 测试单管理
+- `getTestTasks` - 获取测试单列表
+- `getTestTaskDetail` - 获取测试单详情
+- `getTestTaskResults` - 获取测试单的测试结果
+- `runTestCase` - 执行测试用例
+
+### 关联关系查询
+- `getStoryRelatedBugs` - 获取需求关联的 Bug 列表
+- `getBugRelatedStory` - 获取 Bug 关联的需求
+
+### 批量操作
+- `batchUpdateTasks` - 批量更新任务
+- `batchResolveBugs` - 批量解决 Bug
+
+### 数据统计
+- `getMyTaskStatistics` - 获取我的任务统计信息
+- `getMyBugStatistics` - 获取我的 Bug 统计信息
+
+### AI 编程辅助功能
+- `getDevelopmentContext` - 获取需求/Bug 的完整开发上下文（包含关联信息）
+- `generateStorySummary` - 生成需求摘要（支持 JSON/Markdown/文本格式）
+- `generateBugSummary` - 生成 Bug 摘要（支持 JSON/Markdown/文本格式）
+- `formatTaskAsMarkdown` - 将任务格式化为 Markdown
+
+### 智能分析功能
+- `analyzeStoryComplexity` - 分析需求复杂度（评分、工时估算、优先级建议）
+- `analyzeBugPriority` - 分析 Bug 优先级（评分、优先级建议）
+- `analyzeTaskWorkload` - 分析任务工作量（工时估算、难度评估）
+
+### 代码生成提示
+- `generateCodePromptFromStory` - 根据需求生成代码框架提示
+- `generateTestPromptFromBug` - 根据 Bug 生成测试用例提示
+- `generateCodeReviewChecklist` - 生成代码审查检查清单
+
+### 根据需求/Bug创建任务
+- `createTaskFromStory` - 根据需求创建任务（提供手动操作指南）
+- `createTaskFromBug` - 根据Bug创建修复任务（提供手动操作指南）
+
+## 📝 许可证
+
+MIT
+
+## 🔗 相关链接
+
+- [禅道开源版 GitHub](https://github.com/easysoft/zentaopms) - 禅道官方 GitHub 仓库
+- [禅道官网](https://www.zentao.net/)
+

package/dist/config.d.ts

@@ -0,0 +1,9 @@
+export interface ZentaoConfig {
+    url: string;
+    username: string;
+    password: string;
+    apiVersion: 'legacy';
+}
+export declare function saveConfig(config: ZentaoConfig): void;
+export declare function loadConfig(): ZentaoConfig | null;
+export declare function isConfigured(): boolean;

package/dist/config.js

@@ -0,0 +1,54 @@
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+// 定义配置文件路径
+const CONFIG_DIR = path.join(os.homedir(), '.zentao');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+// 保存配置
+export function saveConfig(config) {
+    // 确保配置目录存在
+    if (!fs.existsSync(CONFIG_DIR)) {
+        fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+    // 强制设置为 legacy
+    const legacyConfig = {
+        ...config,
+        apiVersion: 'legacy'
+    };
+    // 写入配置文件
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(legacyConfig, null, 2));
+}
+// 读取配置（优先从环境变量读取，其次从配置文件）
+export function loadConfig() {
+    // 优先从环境变量读取配置
+    const envUrl = process.env.ZENTAO_URL;
+    const envUsername = process.env.ZENTAO_USERNAME;
+    const envPassword = process.env.ZENTAO_PASSWORD;
+    if (envUrl && envUsername && envPassword) {
+        return {
+            url: envUrl,
+            username: envUsername,
+            password: envPassword,
+            apiVersion: 'legacy'
+        };
+    }
+    // 如果环境变量不存在，从配置文件读取
+    try {
+        if (fs.existsSync(CONFIG_FILE)) {
+            const config = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+            // 强制设置为 legacy
+            return {
+                ...config,
+                apiVersion: 'legacy'
+            };
+        }
+    }
+    catch (error) {
+        console.error('读取配置文件失败:', error);
+    }
+    return null;
+}
+// 检查是否已配置
+export function isConfigured() {
+    return fs.existsSync(CONFIG_FILE);
+}

package/dist/errors.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 自定义错误类型
+ */
+export declare enum ErrorCode {
+    AUTH_FAILED = "AUTH_FAILED",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    NOT_FOUND = "NOT_FOUND",
+    INVALID_PARAMS = "INVALID_PARAMS",
+    API_ERROR = "API_ERROR",
+    CONFIG_ERROR = "CONFIG_ERROR",
+    SESSION_EXPIRED = "SESSION_EXPIRED"
+}
+export declare class ZentaoError extends Error {
+    code: ErrorCode;
+    statusCode?: number | undefined;
+    originalError?: any | undefined;
+    constructor(code: ErrorCode, message: string, statusCode?: number | undefined, originalError?: any | undefined);
+    /**
+     * 转换为用户友好的错误消息
+     */
+    toUserFriendlyMessage(): string;
+    /**
+     * 转换为 JSON
+     */
+    toJSON(): {
+        code: ErrorCode;
+        message: string;
+        userFriendlyMessage: string;
+        statusCode: number | undefined;
+        name: string;
+    };
+}
+/**
+ * 创建错误对象
+ */
+export declare function createError(code: ErrorCode, message: string, statusCode?: number, originalError?: any): ZentaoError;

package/dist/errors.js

@@ -0,0 +1,56 @@
+/**
+ * 自定义错误类型
+ */
+export var ErrorCode;
+(function (ErrorCode) {
+    ErrorCode["AUTH_FAILED"] = "AUTH_FAILED";
+    ErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+    ErrorCode["NOT_FOUND"] = "NOT_FOUND";
+    ErrorCode["INVALID_PARAMS"] = "INVALID_PARAMS";
+    ErrorCode["API_ERROR"] = "API_ERROR";
+    ErrorCode["CONFIG_ERROR"] = "CONFIG_ERROR";
+    ErrorCode["SESSION_EXPIRED"] = "SESSION_EXPIRED";
+})(ErrorCode || (ErrorCode = {}));
+export class ZentaoError extends Error {
+    constructor(code, message, statusCode, originalError) {
+        super(message);
+        this.code = code;
+        this.statusCode = statusCode;
+        this.originalError = originalError;
+        this.name = 'ZentaoError';
+        Object.setPrototypeOf(this, ZentaoError.prototype);
+    }
+    /**
+     * 转换为用户友好的错误消息
+     */
+    toUserFriendlyMessage() {
+        const messages = {
+            [ErrorCode.AUTH_FAILED]: '认证失败，请检查用户名和密码',
+            [ErrorCode.NETWORK_ERROR]: '网络连接失败，请检查网络或服务器地址',
+            [ErrorCode.NOT_FOUND]: '未找到请求的资源',
+            [ErrorCode.INVALID_PARAMS]: '参数错误，请检查输入参数',
+            [ErrorCode.API_ERROR]: '禅道 API 返回错误',
+            [ErrorCode.CONFIG_ERROR]: '配置错误，请检查配置信息',
+            [ErrorCode.SESSION_EXPIRED]: 'Session 已过期，请重新初始化连接'
+        };
+        return messages[this.code] || this.message;
+    }
+    /**
+     * 转换为 JSON
+     */
+    toJSON() {
+        return {
+            code: this.code,
+            message: this.message,
+            userFriendlyMessage: this.toUserFriendlyMessage(),
+            statusCode: this.statusCode,
+            name: this.name
+        };
+    }
+}
+/**
+ * 创建错误对象
+ */
+export function createError(code, message, statusCode, originalError) {
+    return new ZentaoError(code, message, statusCode, originalError);
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};