mcp-probe-kit 1.0.0

package/build/tools/check_deps.js

@@ -0,0 +1,204 @@
+// check_deps 工具实现
+export async function checkDeps(args) {
+    try {
+        const message = `请分析项目依赖的健康状况：
+
+---
+
+## 依赖分析步骤
+
+### 第一步：获取依赖信息
+
+执行以下命令：
+\`\`\`bash
+# 查看 package.json
+cat package.json
+
+# 检查过期依赖
+npm outdated
+
+# 检查安全漏洞
+npm audit
+
+# 查看依赖树
+npm list --depth=0
+
+# 分析包大小
+npm ls --prod --parseable | xargs du -sh
+\`\`\`
+
+### 第二步：依赖健康度检查
+
+**1️⃣ 版本检查**
+
+检查项：
+- [ ] 依赖版本是否过旧（> 1 年未更新）
+- [ ] 是否有 Major 版本更新可用
+- [ ] 是否使用了废弃的包
+- [ ] 版本锁定策略（^、~、固定版本）
+
+**2️⃣ 安全漏洞检查**
+
+分析 \`npm audit\` 结果：
+- 🔴 Critical：立即修复
+- 🟠 High：尽快修复
+- 🟡 Moderate：计划修复
+- 🟢 Low：可选修复
+
+**3️⃣ 依赖体积分析**
+
+检查项：
+- [ ] 单个依赖是否过大（> 10MB）
+- [ ] 是否有轻量级替代方案
+- [ ] Tree-shaking 优化机会
+- [ ] 是否可以按需导入
+
+**4️⃣ 依赖健康度评估**
+
+评估指标：
+- 维护状态（活跃/停止维护）
+- 社区活跃度（GitHub Stars/Issues）
+- 发布频率
+- 文档质量
+- TypeScript 支持
+
+**5️⃣ 未使用依赖检查**
+
+查找方法：
+\`\`\`bash
+# 使用 depcheck
+npx depcheck
+
+# 手动检查
+grep -r "from 'package-name'" src/
+\`\`\`
+
+---
+
+## 依赖分析报告
+
+### 📊 依赖统计
+
+**总体情况**：
+- Dependencies: X 个
+- DevDependencies: Y 个
+- 总大小: Z MB
+
+**版本分布**：
+- 最新版本: X 个
+- 需要更新: Y 个
+- 已废弃: Z 个
+
+### 🔴 严重问题
+
+**安全漏洞**：
+1. **package-name@version**
+   - 漏洞等级：Critical
+   - CVE 编号：CVE-2024-XXXX
+   - 影响：...
+   - 修复方案：升级到 version X.X.X
+   - 命令：\`npm install package-name@X.X.X\`
+
+**废弃包**：
+1. **package-name**
+   - 状态：已停止维护
+   - 最后更新：2020-01-01
+   - 替代方案：alternative-package
+   - 迁移指南：...
+
+### 🟡 建议更新
+
+**可用更新**：
+| 包名 | 当前版本 | 最新版本 | 类型 | 优先级 |
+|------|---------|---------|------|--------|
+| pkg1 | 1.0.0 | 2.0.0 | Major | 中 |
+| pkg2 | 1.5.0 | 1.8.0 | Minor | 低 |
+
+**更新建议**：
+1. **Major 更新**（需要测试）：
+   - \`npm install pkg1@2.0.0\`
+   - 查看 Breaking Changes
+
+2. **Minor/Patch 更新**（风险较低）：
+   - \`npm update\`
+
+### 🟢 优化建议
+
+**体积优化**：
+1. **large-package (15MB)**
+   - 建议：使用 tree-shaking
+   - 或替换为：lighter-alternative (2MB)
+   - 预计减少：13MB
+
+**未使用依赖**：
+1. unused-package
+   - 建议：移除
+   - 命令：\`npm uninstall unused-package\`
+
+**重复依赖**：
+1. package-name 存在多个版本
+   - 建议：统一版本
+   - 使用：\`npm dedupe\`
+
+---
+
+## 升级计划
+
+### 立即处理（本周）
+1. 修复 Critical/High 安全漏洞
+2. 移除未使用的依赖
+3. 更新 Patch 版本
+
+### 短期计划（本月）
+1. 更新 Minor 版本
+2. 替换废弃的包
+3. 优化依赖体积
+
+### 长期计划（本季度）
+1. 评估 Major 版本更新
+2. 重构依赖架构
+3. 定期审查依赖健康度
+
+---
+
+## 预防措施
+
+**最佳实践**：
+1. 使用 \`package-lock.json\` 锁定版本
+2. 定期运行 \`npm audit\`
+3. 使用 Dependabot 自动更新
+4. 评估新依赖前检查健康度
+5. 优先选择活跃维护的包
+
+**CI/CD 集成**：
+\`\`\`yaml
+# GitHub Actions 示例
+- name: Audit dependencies
+  run: npm audit --audit-level=moderate
+\`\`\`
+
+---
+
+现在请开始依赖分析，生成详细的分析报告和升级计划。`;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: message,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `❌ 依赖分析失败: ${errorMessage}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}

package/build/tools/code_review.d.ts

@@ -0,0 +1,13 @@
+export declare function codeReview(args: any): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+}>;

package/build/tools/code_review.js

@@ -0,0 +1,138 @@
+// code_review 工具实现
+export async function codeReview(args) {
+    try {
+        const code = args?.code || "";
+        const focus = args?.focus || "all"; // quality, security, performance, all
+        const message = `请对以下代码进行全面审查：
+
+📝 **代码内容**：
+${code || "请提供需要审查的代码"}
+
+🎯 **审查重点**：${focus}
+
+---
+
+## 代码审查清单
+
+### 1️⃣ 代码质量检查
+
+**代码坏味道（Code Smells）**：
+- [ ] 重复代码（Duplicated Code）
+- [ ] 过长函数（Long Function）> 30 行
+- [ ] 过长参数列表（Long Parameter List）> 3 个
+- [ ] 复杂条件判断（Complex Conditional）> 3 层嵌套
+- [ ] 魔法数字（Magic Numbers）
+- [ ] 命名不清晰（Poor Naming）
+
+**设计原则**：
+- [ ] 单一职责原则（SRP）
+- [ ] 开闭原则（OCP）
+- [ ] 接口隔离原则（ISP）
+- [ ] 依赖倒置原则（DIP）
+
+### 2️⃣ 安全漏洞检查
+
+**常见漏洞**：
+- [ ] SQL 注入风险
+- [ ] XSS（跨站脚本）风险
+- [ ] CSRF（跨站请求伪造）
+- [ ] 硬编码密钥/密码
+- [ ] 不安全的随机数生成
+- [ ] 路径遍历漏洞
+- [ ] 未验证的输入
+- [ ] 敏感信息泄露
+
+**安全最佳实践**：
+- [ ] 输入验证和过滤
+- [ ] 输出编码
+- [ ] 使用参数化查询
+- [ ] 密码/密钥使用环境变量
+- [ ] HTTPS 通信
+
+### 3️⃣ 性能问题检查
+
+**性能风险**：
+- [ ] 循环内创建对象
+- [ ] 嵌套循环（O(n²) 或更差）
+- [ ] 不必要的重复计算
+- [ ] 内存泄漏风险
+- [ ] 阻塞主线程
+- [ ] 大数据量未分页
+- [ ] 同步 I/O 操作
+
+**React/Vue 性能**：
+- [ ] 未使用 useMemo/useCallback
+- [ ] 组件不必要的重渲染
+- [ ] 大列表未虚拟化
+- [ ] 状态管理不当
+
+### 4️⃣ 最佳实践检查
+
+**TypeScript/JavaScript**：
+- [ ] 类型定义完整（避免 any）
+- [ ] 错误处理完善（try-catch）
+- [ ] 异步操作正确处理
+- [ ] 使用 const/let 替代 var
+- [ ] 箭头函数合理使用
+
+**命名规范**：
+- [ ] 变量：驼峰命名（camelCase）
+- [ ] 常量：大写下划线（UPPER_CASE）
+- [ ] 类/接口：帕斯卡命名（PascalCase）
+- [ ] 文件：短横线命名（kebab-case）
+- [ ] 布尔值：is/has/should 前缀
+
+**注释和文档**：
+- [ ] 复杂逻辑有注释说明
+- [ ] 公共 API 有文档
+- [ ] TODO/FIXME 标记清晰
+
+---
+
+## 审查报告格式
+
+**严重问题（🔴 Critical）**：
+1. [位置] 问题描述
+   - 风险：...
+   - 建议：...
+   - 修复示例：\`\`\`typescript ... \`\`\`
+
+**警告（🟡 Warning）**：
+1. [位置] 问题描述
+   - 影响：...
+   - 建议：...
+
+**建议（🟢 Suggestion）**：
+1. [位置] 改进建议
+   - 当前：...
+   - 建议：...
+   - 收益：...
+
+**优点（✅ Good）**：
+- 做得好的地方
+
+---
+
+现在请开始代码审查，生成详细的审查报告。`;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: message,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `❌ 代码审查失败: ${errorMessage}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}

package/build/tools/convert.d.ts

@@ -0,0 +1,13 @@
+export declare function convert(args: any): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+}>;