mcp-probe-kit 1.2.9 → 1.4.0

package/README.md

@@ -2,7 +2,7 @@
 
 > 🚀 Cursor 开发增强工具集 - 让 AI 更懂你的开发流程
 
-一个强大的 MCP (Model Context Protocol) 服务器，提供 **23 个实用工具**，覆盖代码质量、开发效率、项目管理全流程。
+一个强大的 MCP (Model Context Protocol) 服务器，提供 **24 个实用工具**，覆盖代码质量、开发效率、项目管理全流程。
 
 **作者**: [小墨 (Kyle)](https://www.bytezonex.com/) | **项目**: [GitHub](https://github.com/mybolide/mcp-probe-kit)
 
@@ -19,7 +19,7 @@
 - **`perf`** - 性能分析
 - **`fix`** - 自动修复代码问题 🆕
 
-### 🛠️ 开发效率（11 个工具）
+### 🛠️ 开发效率（12 个工具）
 - **`gencommit`** - Git 提交消息生成
 - **`genapi`** - API 文档生成
 - **`gendoc`** - 代码注释生成
@@ -27,9 +27,10 @@
 - **`genchangelog`** - Changelog 生成
 - **`gensql`** - SQL 查询生成器 🆕
 - **`genui`** - UI 组件生成器（React + Vue） 🆕
-- **`explain`** - 代码解释器 🆕
-- **`convert`** - 代码转换器 🆕
-- **`genreadme`** - README 生成器 🆕
+- **`explain`** - 代码解释器 🆕
+- **`convert`** - 代码转换器 🆕
+- **`css_order`** - CSS 属性顺序规范 🆕
+- **`genreadme`** - README 生成器 🆕
 - **`split`** - 文件拆分工具 🆕
 
 ### 📦 项目管理（5 个工具）
@@ -230,13 +231,30 @@ npm install mcp-probe-kit
 ### 🛠️ 开发效率工具
 
 #### `gencommit` - 提交生成
-自动分析代码变更，生成规范的 Git commit 消息。
+自动分析代码变更，生成规范的 Git commit 消息（支持 emoji）。
 
 **用法**：`gencommit`
 
-**格式**：`<type>(<scope>): <subject>` (遵循 Conventional Commits)
+**格式**：`<type>: <emoji> <subject>` (遵循 Conventional Commits)
 
-**类型**：feat, fix, docs, style, refactor, test, chore
+**类型**：
+- `fixed` 🐛 - 线上/测试缺陷修复
+- `fix` 🐛 - 语义同 fixed，保持兼容
+- `feat` 🎸 - 新增或迭代业务功能
+- `docs` ✏️ - 文档相关更新
+- `style` 💄 - UI/样式调整
+- `chore` 🤖 - 构建、脚本、依赖等杂项
+- `refactor` ♻️ - 重构
+- `test` ✅ - 测试相关
+
+**示例**：
+```bash
+feat: 🎸 添加用户登录功能
+
+影响模块: auth
+- 实现 JWT 认证机制
+- 添加密码加密存储
+```
 
 ---
 
@@ -332,10 +350,10 @@ npm install mcp-probe-kit
 
 ---
 
-#### `convert` - 代码转换器 🆕
-转换代码格式或框架。
-
-**用法**：`convert @file.js` 然后说明转换类型（如："转为 TypeScript"）
+#### `convert` - 代码转换器 🆕
+转换代码格式或框架。
+
+**用法**：`convert @file.js` 然后说明转换类型（如："转为 TypeScript"）
 
 **支持转换**：
 - JavaScript → TypeScript
@@ -343,13 +361,22 @@ npm install mcp-probe-kit
 - Promises → Async/Await
 - CommonJS → ESM
 - CSS → Tailwind CSS
-- Vue 2 → Vue 3
-- JSON → TypeScript Interface
-
----
-
-#### `genreadme` - README 生成器 🆕
-根据项目代码自动生成 README.md 文档。
+- Vue 2 → Vue 3
+- JSON → TypeScript Interface
+
+---
+
+#### `css_order` - CSS 顺序规范 🆕
+按规则书写或重排 CSS 属性顺序。
+
+**用法**：`css_order`
+
+**包含**：由外向内排序逻辑、五大类属性划分、常用属性示例、快速对比表、重排要求
+
+---
+
+#### `genreadme` - README 生成器 🆕
+根据项目代码自动生成 README.md 文档。
 
 **用法**：`genreadme` 或提供项目信息
 
@@ -531,7 +558,7 @@ npm install mcp-probe-kit
 mcp-probe-kit/
 ├── src/
 │   ├── index.ts              # MCP 服务器主入口
-│   └── tools/                # 工具实现（23 个）
+│   └── tools/                # 工具实现（24 个）
 │       ├── index.ts             # 工具导出
 │       ├── detect_shell.ts      # 套壳检测
 │       ├── code_review.ts       # 代码审查
@@ -547,9 +574,10 @@ mcp-probe-kit/
 │       ├── genchangelog.ts      # Changelog 生成
 │       ├── gensql.ts            # SQL 生成器
 │       ├── genui.ts             # UI 组件生成器
-│       ├── explain.ts           # 代码解释器
-│       ├── convert.ts           # 代码转换器
-│       ├── genreadme.ts         # README 生成器
+│       ├── explain.ts           # 代码解释器
+│       ├── convert.ts           # 代码转换器
+│       ├── css_order.ts         # CSS 顺序规范
+│       ├── genreadme.ts         # README 生成器
 │       ├── split.ts             # 文件拆分工具
 │       ├── init_setting.ts      # 配置初始化
 │       ├── init_project.ts      # 项目初始化
@@ -759,7 +787,7 @@ MIT License
 ### 为什么叫 Probe Kit？
 
 - **Probe（探针）**：探测代码质量、性能瓶颈、依赖健康度
-- **Kit（工具集）**：23 个工具覆盖开发全流程
+- **Kit（工具集）**：24 个工具覆盖开发全流程
 
 ### 工具分类
 
@@ -773,7 +801,7 @@ MIT License
 ├── perf          性能分析
 └── fix           自动修复
 
-开发效率 (11)
+开发效率 (12)
 ├── gencommit     提交生成
 ├── genapi        文档生成
 ├── gendoc        注释生成
@@ -782,9 +810,10 @@ MIT License
 ├── gensql        SQL 生成器
 ├── genui         UI 组件生成器
 ├── explain       代码解释器
-├── convert       代码转换器
-├── genreadme     README 生成器
-└── split         文件拆分工具
+├── convert       代码转换器
+├── css_order     CSS 顺序规范
+├── genreadme     README 生成器
+└── split         文件拆分工具
 
 项目管理 (5)
 ├── init_setting     配置初始化

package/build/index.js

@@ -2,7 +2,7 @@
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { detectShell, initSetting, initProject, gencommit, debug, genapi, codeReview, gentest, genpr, checkDeps, gendoc, genchangelog, refactor, perf, fix, gensql, resolveConflict, genui, explain, convert, genreadme, split, analyzeProject } from "./tools/index.js";
+import { detectShell, initSetting, initProject, gencommit, debug, genapi, codeReview, gentest, genpr, checkDeps, gendoc, genchangelog, refactor, perf, fix, gensql, resolveConflict, genui, explain, convert, cssOrder, genreadme, split, analyzeProject } from "./tools/index.js";
 import { VERSION, NAME } from "./version.js";
 // 创建MCP服务器实例
 const server = new Server({
@@ -373,6 +373,15 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                     required: [],
                 },
             },
+            {
+                name: "css_order",
+                description: "【CSS 顺序】按规则书写或重排 CSS 属性顺序",
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                    required: [],
+                },
+            },
             {
                 name: "genreadme",
                 description: "【README 生成器】根据项目代码生成 README.md 文档",
@@ -479,6 +488,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 return await explain(args);
             case "convert":
                 return await convert(args);
+            case "css_order":
+                return await cssOrder(args);
             case "genreadme":
                 return await genreadme(args);
             case "split":
@@ -553,6 +564,7 @@ server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
                             genui: "enabled",
                             explain: "enabled",
                             convert: "enabled",
+                            css_order: "enabled",
                             genreadme: "enabled",
                             split: "enabled",
                             analyze_project: "enabled",

package/build/tools/analyze_project.js

@@ -12,68 +12,68 @@ export async function analyzeProject(args) {
             content: [
                 {
                     type: "text",
-                    text: `# 📊 项目分析报告
-
-## 🏗️ 项目概览
-- **项目名称**: ${analysis.projectStructure.name}
-- **项目类型**: ${analysis.projectStructure.type}
-- **技术栈**: ${analysis.projectStructure.framework}
-- **主要语言**: ${analysis.projectStructure.language}
-- **包管理器**: ${analysis.projectStructure.packageManager}
-
-## 📁 目录结构
-\`\`\`
-${analysis.directoryTree}
-\`\`\`
-
-## 🔑 关键文件
-${analysis.keyFiles.map(file => `### ${file.path}
-**用途**: ${file.purpose}
-${includeContent ? `\`\`\`${getFileExtension(file.path)}
-${file.content.substring(0, 500)}${file.content.length > 500 ? '\n...' : ''}
-\`\`\`` : ''}`).join('\n\n')}
-
-## 📦 依赖分析
-- **生产依赖**: ${analysis.dependencies.production.length} 个
-- **开发依赖**: ${analysis.dependencies.development.length} 个
-- **总依赖数**: ${analysis.dependencies.total} 个
-
-### 主要依赖
-${analysis.dependencies.production.slice(0, 10).map(dep => `- ${dep}`).join('\n')}
-
-## 📈 代码指标
-- **总文件数**: ${analysis.codeMetrics.totalFiles}
-- **总行数**: ${analysis.codeMetrics.totalLines}
-${analysis.codeMetrics.skippedFiles > 0 ? `- **跳过文件**: ${analysis.codeMetrics.skippedFiles} 个（过大或无法读取）` : ''}
-- **文件类型分布**:
+                    text: `# 📊 项目分析报告
+
+## 🏗️ 项目概览
+- **项目名称**: ${analysis.projectStructure.name}
+- **项目类型**: ${analysis.projectStructure.type}
+- **技术栈**: ${analysis.projectStructure.framework}
+- **主要语言**: ${analysis.projectStructure.language}
+- **包管理器**: ${analysis.projectStructure.packageManager}
+
+## 📁 目录结构
+\`\`\`
+${analysis.directoryTree}
+\`\`\`
+
+## 🔑 关键文件
+${analysis.keyFiles.map(file => `### ${file.path}
+**用途**: ${file.purpose}
+${includeContent ? `\`\`\`${getFileExtension(file.path)}
+${file.content.substring(0, 500)}${file.content.length > 500 ? '\n...' : ''}
+\`\`\`` : ''}`).join('\n\n')}
+
+## 📦 依赖分析
+- **生产依赖**: ${analysis.dependencies.production.length} 个
+- **开发依赖**: ${analysis.dependencies.development.length} 个
+- **总依赖数**: ${analysis.dependencies.total} 个
+
+### 主要依赖
+${analysis.dependencies.production.slice(0, 10).map(dep => `- ${dep}`).join('\n')}
+
+## 📈 代码指标
+- **总文件数**: ${analysis.codeMetrics.totalFiles}
+- **总行数**: ${analysis.codeMetrics.totalLines}
+${analysis.codeMetrics.skippedFiles > 0 ? `- **跳过文件**: ${analysis.codeMetrics.skippedFiles} 个（过大或无法读取）` : ''}
+- **文件类型分布**:
 ${Object.entries(analysis.codeMetrics.fileTypes)
                         .sort(([, a], [, b]) => b - a)
                         .slice(0, 10)
                         .map(([type, count]) => `  - ${type}: ${count} 个文件`)
-                        .join('\n')}
-${Object.keys(analysis.codeMetrics.fileTypes).length > 10 ? '  - ... (更多类型已省略)' : ''}
-
-### 最大文件
-${analysis.codeMetrics.largestFiles.slice(0, 5).map(file => `- ${file.path} (${file.lines} 行)`).join('\n')}
-
-## 🏛️ 架构分析
-- **设计模式**: ${analysis.architecture.patterns.join(', ')}
-- **入口文件**: ${analysis.architecture.entryPoints.join(', ')}
-- **核心模块**: ${analysis.architecture.mainModules.join(', ')}
-
-## 📋 项目总结
-**项目目的**: ${analysis.summary.purpose}
-**复杂度**: ${analysis.summary.complexity}
-**建议**: 
-${analysis.summary.recommendations.map(rec => `- ${rec}`).join('\n')}
-
----
-*分析完成时间: ${new Date().toLocaleString('zh-CN')}*
-*分析工具: MCP Probe Kit v${VERSION}*
-
-**分析说明**:
-- 大型项目会自动采样分析，限制最多扫描 5000 个文件
-- 已自动忽略以下目录: \`node_modules\`, \`dist\`, \`build\`, \`.git\`, \`coverage\`, \`.next\`, \`.nuxt\`, \`vendor\` 等
+                        .join('\n')}
+${Object.keys(analysis.codeMetrics.fileTypes).length > 10 ? '  - ... (更多类型已省略)' : ''}
+
+### 最大文件
+${analysis.codeMetrics.largestFiles.slice(0, 5).map(file => `- ${file.path} (${file.lines} 行)`).join('\n')}
+
+## 🏛️ 架构分析
+- **设计模式**: ${analysis.architecture.patterns.join(', ')}
+- **入口文件**: ${analysis.architecture.entryPoints.join(', ')}
+- **核心模块**: ${analysis.architecture.mainModules.join(', ')}
+
+## 📋 项目总结
+**项目目的**: ${analysis.summary.purpose}
+**复杂度**: ${analysis.summary.complexity}
+**建议**: 
+${analysis.summary.recommendations.map(rec => `- ${rec}`).join('\n')}
+
+---
+*分析完成时间: ${new Date().toLocaleString('zh-CN')}*
+*分析工具: MCP Probe Kit v${VERSION}*
+
+**分析说明**:
+- 大型项目会自动采样分析，限制最多扫描 5000 个文件
+- 已自动忽略以下目录: \`node_modules\`, \`dist\`, \`build\`, \`.git\`, \`coverage\`, \`.next\`, \`.nuxt\`, \`vendor\` 等
 - 单个文件大小限制: 1MB，超过则跳过`,
                 },
             ],

package/build/tools/css_order.d.ts

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

package/build/tools/css_order.js

@@ -0,0 +1,81 @@
+// css_order 工具实现
+export async function cssOrder(_args) {
+    try {
+        const message = `请根据以下规则**书写或重排 CSS**（不是解释规则）。目标是让 CSS 属性顺序更一致、可读、可维护。
+
+如果我提供了 CSS 片段/文件，请直接给出**已按规则整理后的 CSS**；如果没提供，请先让我提供需要处理的 CSS。
+
+---
+
+## 排序逻辑（由外向内，由大到小）
+
+将属性分为五类，按顺序排列：
+
+### 1. 定位属性 (Positioning)
+决定元素“在哪里”。
+- \`position\` / \`z-index\` / \`top\` / \`right\` / \`bottom\` / \`left\` / \`float\` / \`clear\`
+
+### 2. 盒子模型 (Box Model)
+决定元素“占多大空间”。
+- \`display\` / \`flex\` / \`grid\` 相关属性
+- \`width\` / \`height\` / \`max-width\` / \`min-width\`
+- \`margin\` / \`padding\` / \`border\`
+- \`box-sizing\` / \`overflow\`
+
+### 3. 文本排版 (Typography)
+决定元素内“文字内容”的样式。
+- \`font-family\` / \`font-size\` / \`font-weight\` / \`line-height\`
+- \`text-align\` / \`text-transform\` / \`text-decoration\` / \`letter-spacing\` / \`white-space\` / \`color\`
+
+### 4. 视觉表现 (Visual/Decoration)
+决定元素“皮肤”的外观。
+- \`background\` / \`box-shadow\` / \`opacity\` / \`visibility\` / \`cursor\` / \`outline\`
+
+### 5. 其他与交互 (Misc/Transitions)
+动效和交互相关。
+- \`transition\` / \`animation\` / \`transform\` / \`will-change\`
+
+---
+
+## 处理要求
+
+1. **只调整属性顺序，不改动语义**（除非存在明显重复/冲突属性）。
+2. **保留注释与格式风格**（缩进、空行、选择器顺序不变）。
+3. **同类属性保持原有相对顺序**，除非有明显更合理的排序。
+4. 如果存在 **CSS 变量**（\`--*\`）或自定义属性，放在**当前类的最前**。
+5. 如遇 CSS-in-JS、Tailwind 或非标准语法，**只处理可确定的纯 CSS 属性**。
+
+---
+
+## 快速对比表
+
+| 顺序 | 类别 | 常用属性举例 | 核心目的 |
+| --- | --- | --- | --- |
+| **1** | **定位** | \`position\`, \`z-index\`, \`top\` | 确定位置 |
+| **2** | **盒模型** | \`display\`, \`width\`, \`margin\`, \`padding\` | 确定形状和间距 |
+| **3** | **排版** | \`font\`, \`line-height\`, \`color\`, \`text-align\` | 确定内容样式 |
+| **4** | **视觉** | \`background\`, \`border-radius\`, \`box-shadow\` | 确定外观修饰 |
+| **5** | **其他** | \`transition\`, \`transform\`, \`animation\` | 确定动态交互 |
+`;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: message,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `❌ CSS 顺序规范生成失败: ${errorMessage}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}

package/build/tools/index.d.ts

@@ -18,6 +18,7 @@ export { resolveConflict } from "./resolve_conflict.js";
 export { genui } from "./genui.js";
 export { explain } from "./explain.js";
 export { convert } from "./convert.js";
+export { cssOrder } from "./css_order.js";
 export { genreadme } from "./genreadme.js";
 export { split } from "./split.js";
 export { analyzeProject } from "./analyze_project.js";

package/build/tools/index.js

@@ -18,6 +18,7 @@ export { resolveConflict } from "./resolve_conflict.js";
 export { genui } from "./genui.js";
 export { explain } from "./explain.js";
 export { convert } from "./convert.js";
+export { cssOrder } from "./css_order.js";
 export { genreadme } from "./genreadme.js";
 export { split } from "./split.js";
 export { analyzeProject } from "./analyze_project.js";

package/package.json

@@ -1,65 +1,65 @@
-{
-  "name": "mcp-probe-kit",
-  "version": "1.2.9",
-  "description": "Cursor Development Enhancement Toolkit - MCP Server with 23 practical tools for code quality, development efficiency, and project management",
-  "type": "module",
-  "main": "build/index.js",
-  "bin": {
-    "mcp-probe-kit": "build/index.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "watch": "tsc --watch",
-    "dev": "tsc && node build/index.js",
-    "test": "npm run build && node test-server.js",
-    "inspector": "npx @modelcontextprotocol/inspector node build/index.js",
-    "prepare": "npm run build",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "cursor",
-    "ai-tools",
-    "development-tools",
-    "code-quality",
-    "code-review",
-    "refactor",
-    "debugging",
-    "sql-generator",
-    "ui-generator",
-    "react",
-    "vue",
-    "typescript",
-    "git-tools",
-    "ai-assistant"
-  ],
-  "author": {
-    "name": "小墨 (Kyle)",
-    "url": "https://www.bytezonex.com/"
-  },
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/mybolide/mcp-probe-kit.git"
-  },
-  "bugs": {
-    "url": "https://github.com/mybolide/mcp-probe-kit/issues"
-  },
-  "homepage": "https://github.com/mybolide/mcp-probe-kit#readme",
-  "engines": {
-    "node": ">=16.0.0"
-  },
-  "files": [
-    "build",
-    "README.md",
-    "LICENSE"
-  ],
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^0.5.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "typescript": "^5.3.0"
-  }
-}
+{
+  "name": "mcp-probe-kit",
+  "version": "1.4.0",
+  "description": "Cursor Development Enhancement Toolkit - MCP Server with 24 practical tools for code quality, development efficiency, and project management",
+  "type": "module",
+  "main": "build/index.js",
+  "bin": {
+    "mcp-probe-kit": "build/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "dev": "tsc && node build/index.js",
+    "test": "npm run build && node test-server.js",
+    "inspector": "npx @modelcontextprotocol/inspector node build/index.js",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "cursor",
+    "ai-tools",
+    "development-tools",
+    "code-quality",
+    "code-review",
+    "refactor",
+    "debugging",
+    "sql-generator",
+    "ui-generator",
+    "react",
+    "vue",
+    "typescript",
+    "git-tools",
+    "ai-assistant"
+  ],
+  "author": {
+    "name": "小墨 (Kyle)",
+    "url": "https://www.bytezonex.com/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mybolide/mcp-probe-kit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mybolide/mcp-probe-kit/issues"
+  },
+  "homepage": "https://github.com/mybolide/mcp-probe-kit#readme",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "files": [
+    "build",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^0.5.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0"
+  }
+}