Merge pull request #42 from TencentCloudBase/claude/issue-35-20250708_143452

feat: 为 MCP 工具错误添加 GitHub Issue 快速创建链接

Author: binggg

mcp/src/utils/tool-wrapper.ts

@@ -2,6 +2,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { ToolAnnotations, Tool } from "@modelcontextprotocol/sdk/types.js";
 import { reportToolCall } from './telemetry.js';
 import { debug } from './logger.js';
+import os from 'os';
 
 /**
  * 工具包装器，为 MCP 工具添加数据上报功能
@@ -11,6 +12,58 @@ import { debug } from './logger.js';
 // 重新导出 MCP SDK 的类型，方便其他模块使用
 export type { ToolAnnotations, Tool } from "@modelcontextprotocol/sdk/types.js";
 
+/**
+ * 生成 GitHub Issue 创建链接
+ * @param toolName 工具名称
+ * @param errorMessage 错误消息
+ * @param args 工具参数
+ * @returns GitHub Issue 创建链接
+ */
+function generateGitHubIssueLink(toolName: string, errorMessage: string, args: any): string {
+    const baseUrl = 'https://github.com/TencentCloudBase/CloudBase-AI-ToolKit/issues/new';
+    
+    // 构建标题
+    const title = `MCP工具错误: ${toolName}`;
+    
+    // 构建问题描述
+    const body = `## 错误描述
+工具 \`${toolName}\` 执行时发生错误
+
+## 错误信息
+\`\`\`
+${errorMessage}
+\`\`\`
+
+## 环境信息
+- 操作系统: ${os.type()} ${os.release()}
+- Node.js版本: ${process.version}
+- 系统架构: ${os.arch()}
+- 时间: ${new Date().toISOString()}
+
+## 工具参数
+\`\`\`json
+${JSON.stringify(sanitizeArgs(args), null, 2)}
+\`\`\`
+
+## 复现步骤
+1. 使用工具: ${toolName}
+2. 传入参数: [请根据上述参数信息填写]
+3. 出现错误
+
+## 期望行为
+[请描述您期望的正确行为]
+
+## 其他信息
+[如有其他相关信息，请在此补充]
+`;
+
+    // URL 编码
+    const encodedTitle = encodeURIComponent(title);
+    const encodedBody = encodeURIComponent(body);
+    
+    return `${baseUrl}?title=${encodedTitle}&body=${encodedBody}`;
+}
+
 /**
  * 创建包装后的处理函数，添加数据上报功能
  */
@@ -39,8 +92,25 @@ function createWrappedHandler(name: string, handler: any) {
                 duration: Date.now() - startTime
             });
 
-            // 重新抛出错误，保持原有行为
-            throw error;
+            // 生成 GitHub Issue 创建链接
+            const issueLink = generateGitHubIssueLink(name, errorMessage, args);
+            
+            // 创建增强的错误消息，包含 GitHub Issue 链接
+            const enhancedErrorMessage = `${errorMessage}\n\n🔗 遇到问题？请点击以下链接快速创建 GitHub Issue：\n${issueLink}`;
+            
+            // 创建新的错误对象，保持原有的错误类型但更新消息
+            const enhancedError = error instanceof Error 
+                ? new Error(enhancedErrorMessage)
+                : new Error(enhancedErrorMessage);
+            
+            // 保持原有的错误属性
+            if (error instanceof Error) {
+                enhancedError.stack = error.stack;
+                enhancedError.name = error.name;
+            }
+
+            // 重新抛出增强的错误
+            throw enhancedError;
         } finally {
             // 上报工具调用数据
             const duration = Date.now() - startTime;