@zzp123/mcp-zentao 1.2.2 → 1.3.1

package/dist/index.js

@@ -990,49 +990,100 @@ server.tool("uploadFile", {
     return { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] };
 });
 server.tool("uploadImageFromClipboard", {
-    base64Data: z.string(),
     filename: z.string().optional(),
     uid: z.string().optional()
-}, async ({ base64Data, filename, uid }) => {
+}, async ({ filename, uid }) => {
     if (!zentaoApi)
         throw new Error("Please initialize Zentao API first");
     const fs = await import('fs');
     const path = await import('path');
-    // 创建 img 文件夹（如果不存在）
-    const imgDir = path.join(process.cwd(), 'img');
-    if (!fs.existsSync(imgDir)) {
-        fs.mkdirSync(imgDir, { recursive: true });
-    }
-    let fileBuffer;
-    let finalFilename;
-    // 处理 base64 数据
-    const matches = base64Data.match(/^data:image\/(\w+);base64,(.+)$/);
-    if (matches) {
-        const ext = matches[1];
-        const data = matches[2];
-        fileBuffer = Buffer.from(data, 'base64');
-        finalFilename = filename || `clipboard_${Date.now()}.${ext}`;
+    const { execSync } = await import('child_process');
+    try {
+        // 读取系统剪贴板图片
+        let base64Data;
+        let fileBuffer;
+        let finalFilename;
+        // Windows: 使用 PowerShell 读取剪贴板
+        if (process.platform === 'win32') {
+            const psScript = `
+                Add-Type -AssemblyName System.Windows.Forms
+                $img = [System.Windows.Forms.Clipboard]::GetImage()
+                if ($img -ne $null) {
+                    $ms = New-Object System.IO.MemoryStream
+                    $img.Save($ms, [System.Drawing.Imaging.ImageFormat]::Png)
+                    [Convert]::ToBase64String($ms.ToArray())
+                } else {
+                    Write-Error "NoImage"
+                }
+            `;
+            const result = execSync(`powershell -Command "${psScript.replace(/\n/g, ' ')}"`, {
+                encoding: 'utf8',
+                maxBuffer: 10 * 1024 * 1024,
+                stdio: ['pipe', 'pipe', 'pipe']
+            }).trim();
+            if (!result || result.includes('NoImage') || result.includes('Error')) {
+                throw new Error('剪贴板中没有图片。请先复制图片，不要粘贴到输入框，直接告诉我"上传"。');
+            }
+            base64Data = result;
+            fileBuffer = Buffer.from(base64Data, 'base64');
+            finalFilename = filename || `clipboard_${Date.now()}.png`;
+        }
+        // macOS: 使用 pngpaste
+        else if (process.platform === 'darwin') {
+            const tempFile = path.join(process.cwd(), '.temp_clipboard.png');
+            try {
+                execSync(`pngpaste "${tempFile}"`);
+                fileBuffer = fs.readFileSync(tempFile);
+                fs.unlinkSync(tempFile);
+                finalFilename = filename || `clipboard_${Date.now()}.png`;
+            }
+            catch {
+                throw new Error('剪贴板中没有图片。请先安装 pngpaste: brew install pngpaste');
+            }
+        }
+        // Linux: 使用 xclip
+        else {
+            try {
+                const buffer = execSync('xclip -selection clipboard -t image/png -o', {
+                    maxBuffer: 10 * 1024 * 1024
+                });
+                fileBuffer = buffer;
+                finalFilename = filename || `clipboard_${Date.now()}.png`;
+            }
+            catch {
+                throw new Error('剪贴板中没有图片。请先安装 xclip: sudo apt-get install xclip');
+            }
+        }
+        // 创建 img 文件夹
+        const imgDir = path.join(process.cwd(), 'img');
+        if (!fs.existsSync(imgDir)) {
+            fs.mkdirSync(imgDir, { recursive: true });
+        }
+        // 保存到 img 文件夹
+        const savedPath = path.join(imgDir, finalFilename);
+        fs.writeFileSync(savedPath, fileBuffer);
+        // 上传到禅道
+        const result = await zentaoApi.uploadFile({
+            file: fileBuffer,
+            filename: finalFilename,
+            uid
+        });
+        const response = {
+            upload: result,
+            savedPath: savedPath,
+            message: `图片已保存到本地并上传到禅道`
+        };
+        return { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] };
     }
-    else {
-        // 直接的 base64 数据，没有 data URL 前缀
-        fileBuffer = Buffer.from(base64Data, 'base64');
-        finalFilename = filename || `clipboard_${Date.now()}.png`;
+    catch (error) {
+        return {
+            content: [{
+                    type: "text",
+                    text: `错误: ${error.message}\n\n提示：\n1. 确保已复制图片到剪贴板\n2. 不要粘贴到输入框，直接说"上传剪贴板图片"\n3. 或使用命令行: upload.bat`
+                }],
+            isError: true
+        };
     }
-    // 保存到 img 文件夹
-    const savedPath = path.join(imgDir, finalFilename);
-    fs.writeFileSync(savedPath, fileBuffer);
-    // 上传到禅道
-    const result = await zentaoApi.uploadFile({
-        file: fileBuffer,
-        filename: finalFilename,
-        uid
-    });
-    const response = {
-        upload: result,
-        savedPath: savedPath,
-        message: `图片已保存到本地并上传到禅道`
-    };
-    return { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] };
 });
 server.tool("downloadFile", {
     fileId: z.number(),

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zzp123/mcp-zentao",
-    "version": "1.2.2",
+    "version": "1.3.1",
     "description": "禅道项目管理系统的高级API集成包，提供任务管理、Bug跟踪等功能的完整封装，专为Cursor IDE设计的MCP扩展",
     "main": "dist/index.js",
     "type": "module",
@@ -11,7 +11,8 @@
     "files": [
         "dist",
         "README.md",
-        "json-args.js"
+        "json-args.js",
+        "scripts"
     ],
     "scripts": {
         "build": "tsc",
@@ -21,7 +22,9 @@
         "test:watch": "jest --watch",
         "test:manual": "ts-node test/manual-test.ts",
         "prepublishOnly": "npm run test && npm run build",
-        "start": "node json-args.js"
+        "start": "node json-args.js",
+        "upload:clipboard": "node scripts/upload-clipboard-image.js",
+        "upload:clipboard:py": "python scripts/upload-clipboard-image.py"
     },
     "keywords": [
         "mcp",

package/scripts/MCP-INTEGRATION.md

@@ -0,0 +1,298 @@
+# MCP 集成说明
+
+## 🔗 与 MCP 工具联动
+
+本项目提供了两种方式来上传剪贴板图片到禅道：
+
+### 方式1: 通过 MCP 工具（在 Claude Code 中使用）
+
+**适用场景：** 在 Claude Code 对话中直接上传图片
+
+**已有的 MCP 工具：**
+
+1. **uploadImageFromClipboard** - 专门用于上传剪贴板图片
+   ```json
+   {
+     "base64Data": "data:image/png;base64,...",
+     "filename": "optional-name.png",
+     "uid": "optional-uid"
+   }
+   ```
+
+2. **uploadFile** - 通用文件上传（支持路径或 base64）
+   ```json
+   {
+     "filePath": "/path/to/file.png",
+     "base64Data": "data:image/png;base64,...",
+     "filename": "optional-name.png",
+     "uid": "optional-uid"
+   }
+   ```
+
+**使用方法：**
+
+在 Claude Code 中：
+```
+你：复制一张图片后，对 Claude 说：
+"上传这张图片到禅道"
+
+Claude 会自动：
+1. 获取剪贴板中的图片 base64 数据
+2. 调用 uploadImageFromClipboard 工具
+3. 保存图片到 ./img/ 文件夹
+4. 上传到禅道
+5. 返回文件 ID 和 URL
+```
+
+---
+
+### 方式2: 通过命令行脚本（独立使用）
+
+**适用场景：** 在终端/命令行中快速上传图片，不需要启动 Claude Code
+
+**提供的脚本：**
+
+1. **Node.js 脚本** - `scripts/upload-clipboard-image.js`
+2. **PowerShell 脚本** - `scripts/upload-clipboard-image.ps1`
+3. **Python 脚本** - `scripts/upload-clipboard-image.py`
+
+**使用方法：**
+
+```bash
+# 方式1: 使用 npm scripts
+npm run upload:clipboard
+
+# 方式2: 直接运行脚本
+node scripts/upload-clipboard-image.js
+python scripts/upload-clipboard-image.py
+.\scripts\upload-clipboard-image.ps1 -ZentaoUrl "..." -Username "..." -Password "..."
+```
+
+---
+
+## 🔄 两种方式的区别
+
+| 对比项 | MCP 工具 | 命令行脚本 |
+|--------|---------|-----------|
+| **使用场景** | 在 Claude Code 对话中 | 独立在终端使用 |
+| **启动方式** | 告诉 Claude 上传图片 | 运行命令 |
+| **配置方式** | MCP 工具自动获取配置 | 需要设置环境变量 |
+| **图片来源** | Claude 自动获取剪贴板 | 脚本读取剪贴板 |
+| **适合人群** | 使用 Claude Code 的用户 | 喜欢命令行的开发者 |
+| **优势** | 无缝集成，对话式操作 | 快速、独立、可自动化 |
+
+---
+
+## 💡 推荐使用场景
+
+### 场景1: 在编写需求/Bug时上传截图
+
+**使用 MCP 工具：**
+```
+你：我要创建一个Bug
+Claude：好的，请提供Bug的详细信息
+你：[复制截图] 上传这张截图
+Claude：✓ 图片已上传，文件ID: 123, URL: /zentao/file-read-123.png
+你：创建Bug，标题是"登录页面样式错误"，把刚才的图片加到描述里
+Claude：✓ Bug已创建，ID: 456
+```
+
+### 场景2: 批量处理图片
+
+**使用命令行脚本：**
+```bash
+# 创建一个循环脚本
+while true; do
+    echo "按任意键上传当前剪贴板图片..."
+    read
+    npm run upload:clipboard
+done
+```
+
+### 场景3: 与其他工具集成
+
+**使用命令行脚本：**
+```bash
+# 截图后自动上传
+# Mac Automator / Windows Task Scheduler
+
+# 1. 截图工具保存图片
+screencapture -c
+
+# 2. 自动上传
+npm run upload:clipboard
+
+# 3. 将URL复制到剪贴板
+# (脚本可修改为返回URL到剪贴板)
+```
+
+---
+
+## 🛠️ 高级集成
+
+### 1. 添加为 MCP 子命令
+
+可以创建一个 MCP 工具来调用命令行脚本：
+
+```typescript
+// 在 src/index.ts 中添加
+server.tool("uploadClipboardViaCLI", {
+    method: z.enum(['node', 'python', 'powershell']).optional()
+}, async ({ method = 'node' }) => {
+    const { exec } = await import('child_process');
+    const { promisify } = await import('util');
+    const execAsync = promisify(exec);
+
+    const command = method === 'python'
+        ? 'python scripts/upload-clipboard-image.py'
+        : method === 'powershell'
+        ? 'powershell -File scripts/upload-clipboard-image.ps1 ...'
+        : 'node scripts/upload-clipboard-image.js';
+
+    const { stdout, stderr } = await execAsync(command);
+    return { content: [{ type: "text", text: stdout || stderr }] };
+});
+```
+
+### 2. 创建快捷命令
+
+**package.json:**
+```json
+{
+  "scripts": {
+    "zentao:upload": "npm run upload:clipboard",
+    "zentao:upload:watch": "nodemon --watch clipboard --exec 'npm run upload:clipboard'"
+  }
+}
+```
+
+### 3. 集成到 Git Hooks
+
+**.git/hooks/pre-commit:**
+```bash
+#!/bin/bash
+# 在提交前自动上传截图到禅道
+
+if git diff --cached --name-only | grep -q "screenshots/"; then
+    echo "检测到新截图，自动上传到禅道..."
+    npm run upload:clipboard
+fi
+```
+
+### 4. VS Code Task 集成
+
+**.vscode/tasks.json:**
+```json
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "Upload Clipboard to Zentao",
+      "type": "npm",
+      "script": "upload:clipboard",
+      "problemMatcher": [],
+      "presentation": {
+        "reveal": "always",
+        "panel": "new"
+      }
+    }
+  ]
+}
+```
+
+然后使用 `Ctrl+Shift+B` 选择任务运行。
+
+---
+
+## 📊 完整工作流示例
+
+### 工作流1: 使用 MCP（推荐）
+
+```mermaid
+graph LR
+    A[复制图片] --> B[告诉Claude上传]
+    B --> C[Claude调用MCP工具]
+    C --> D[自动保存到img/]
+    D --> E[上传到禅道]
+    E --> F[返回ID和URL]
+    F --> G[在对话中使用]
+```
+
+**优点：**
+- ✅ 无需离开对话界面
+- ✅ 自动化程度高
+- ✅ 与其他操作串联
+- ✅ 无需配置环境变量
+
+### 工作流2: 使用命令行
+
+```mermaid
+graph LR
+    A[复制图片] --> B[运行脚本]
+    B --> C[读取剪贴板]
+    C --> D[保存到img/]
+    D --> E[上传到禅道]
+    E --> F[显示结果]
+    F --> G[手动复制URL]
+```
+
+**优点：**
+- ✅ 快速独立
+- ✅ 可自动化
+- ✅ 可集成到其他工具
+- ✅ 不依赖 Claude Code
+
+---
+
+## 🎯 最佳实践
+
+### 1. 选择合适的方式
+
+- **日常使用** → MCP 工具（在 Claude Code 中）
+- **批量处理** → 命令行脚本
+- **自动化集成** → 命令行脚本 + 系统工具
+
+### 2. 配置管理
+
+**MCP 方式：**
+- 使用 `.zentao/config.json` 存储配置
+- 通过 `initZentao` 工具初始化
+
+**命令行方式：**
+- 创建 `.env` 文件
+- 或创建 `upload.bat` / `upload.sh` 包含配置
+- 不要将密码提交到版本控制
+
+### 3. 图片管理
+
+- 所有图片统一保存到 `./img/` 文件夹
+- 文件名格式：`clipboard_时间戳.png` 或 `image_时间戳.png`
+- 可在 `.gitignore` 中添加 `img/` 避免提交
+
+### 4. 错误处理
+
+- 检查剪贴板是否有图片
+- 验证禅道连接
+- 记录上传日志
+- 自动重试机制（可选）
+
+---
+
+## 📚 相关文档
+
+- [脚本使用说明](./README.md)
+- [MCP 工具列表](../README.md#api-tools)
+- [禅道API文档](../禅道API文档.md)
+
+---
+
+## 🤝 贡献
+
+如果您有更好的集成方案，欢迎提交 PR！
+
+可能的改进方向：
+- 监听剪贴板变化自动上传
+- 支持拖拽上传
+- 批量上传多张图片
+- 图片压缩/优化
+- 上传历史记录