congmao-cli 1.0.0

package/README.md

@@ -0,0 +1,2 @@
+# cm-cli
+cli

package/bin/index.js

@@ -0,0 +1,20 @@
+#! /usr/bin/env node
+
+import { program } from "commander";
+import create from "../src/commands/create.js";
+import mcp from "../src/commands/mcp.js";
+import { showLogo } from "../src/utils/logo.js";
+
+showLogo();
+
+program.name("cm-cli").version("1.0.0");
+
+program.command("create").description("创建初始化项目").action(create);
+
+program
+  .command("mcp")
+  .description("启动 MCP stdio 服务器并显示配置信息（用于 Cursor）")
+  .option("--config-only", "仅显示配置信息，不启动服务器", false)
+  .action(mcp);
+
+program.parse();

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "congmao-cli",
+  "version": "1.0.0",
+  "description": "cli",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "cm": "bin/index.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "package.json",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "prepublishOnly": "node scripts/prepublish.js",
+    "postinstall": "cd src/mcp && npm install --no-save || true"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aZeroDoubleSeven/cm-cli.git"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/aZeroDoubleSeven/cm-cli/issues"
+  },
+  "homepage": "https://github.com/aZeroDoubleSeven/cm-cli#readme",
+  "dependencies": {
+    "@clack/prompts": "^0.11.0",
+    "boxen": "^8.0.1",
+    "chalk": "^5.4.1",
+    "commander": "^11.0.0",
+    "ejs": "^3.1.9",
+    "gradient-string": "^3.0.0",
+    "inquirer": "^9.2.12",
+    "lerna": "^8.1.9"
+  }
+}

package/src/commands/create.js

@@ -0,0 +1,171 @@
+import {
+  intro,
+  outro,
+  text,
+  select,
+  confirm,
+  spinner,
+  cancel,
+  isCancel,
+} from '@clack/prompts';
+import gradient from 'gradient-string';
+import path from "node:path";
+import fs from "node:fs";
+import chalk from "chalk";
+import { fileURLToPath } from "node:url";
+
+import copyDir from "../utils/copy.js";
+import renderTemplates from "../utils/render.js";
+import setupESLint from "../utils/eslint.js";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+/**
+ * 根据模板类型获取启动命令
+ */
+function getStartCommand(templateName, needESLint) {
+  const commands = {
+    'Uni-app': {
+      install: 'pnpm install',
+      lint: needESLint ? 'pnpm run lint' : null,
+      dev: 'pnpm run dev:h5'
+    },
+    'Vue2': {
+      install: 'pnpm install',
+      lint: needESLint ? 'pnpm run lint' : null,
+      dev: 'pnpm run dev'
+    },
+    'Vue3': {
+      install: 'pnpm install',
+      lint: needESLint ? 'pnpm run lint' : null,
+      dev: 'pnpm run dev'
+    }
+  };
+
+  return commands[templateName] || commands['Vue2'];
+}
+
+export default async function create() {
+  // 显示欢迎信息
+  intro(gradient(['#00FFFF', '#00CED1', '#00BFFF', '#00FF7F'])('欢迎使用丛茂科技 CM CLI ! 🚀'));
+
+  // 1. 选择项目类型
+  const projectType = await select({
+    message: '请选择项目类型：',
+    options: [
+      { value: 'mobile', label: '移动端', hint: '适用于移动端应用开发' },
+      { value: 'miniprogram', label: '小程序', hint: '适用于小程序开发' },
+      { value: 'admin', label: '后台管理系统', hint: '适用于后台管理系统开发' },
+    ],
+  });
+
+  if (isCancel(projectType)) {
+    cancel('操作已取消');
+    process.exit(0);
+  }
+
+  // 2. 根据项目类型选择具体模板
+  let templateName;
+
+  if (projectType === 'mobile' || projectType === 'miniprogram') {
+    // 移动端和小程序使用 Uni-app
+    templateName = 'Uni-app';
+  } else if (projectType === 'admin') {
+    // 后台管理系统选择 Vue 版本
+    const vueVersion = await select({
+      message: '请选择 Vue 版本：',
+      options: [
+        { value: 'Vue2', label: 'Vue 2', hint: '稳定版本' },
+        { value: 'Vue3', label: 'Vue 3', hint: '最新版本' },
+      ],
+    });
+
+    if (isCancel(vueVersion)) {
+      cancel('操作已取消');
+      process.exit(0);
+    }
+
+    templateName = vueVersion;
+  }
+
+  // 3. 获取项目名称
+  const projectName = await text({
+    message: '请输入项目名称：',
+    placeholder: projectType === 'admin' ? 'admin-project' : 'uni-app-project',
+    validate: (value) => {
+      if (!value) return '项目名称不能为空';
+      if (!/^[a-z0-9-]+$/.test(value)) {
+        return '只能包含小写字母、数字和连字符';
+      }
+    },
+  });
+
+  if (isCancel(projectName)) {
+    cancel('操作已取消');
+    process.exit(0);
+  }
+
+  // 4. 询问是否配置 ESLint
+  const needESLint = await confirm({
+    message: '是否配置 ESLint？',
+    initialValue: true,
+  });
+
+  if (isCancel(needESLint)) {
+    cancel('操作已取消');
+    process.exit(0);
+  }
+
+  // 5. 检查目录是否存在
+  const targetDir = path.resolve(process.cwd(), projectName);
+
+  if (fs.existsSync(targetDir)) {
+    cancel(chalk.red('❌ 目录已存在'));
+    process.exit(1);
+  }
+
+  // 6. 创建项目
+  const s = spinner();
+  s.start('正在创建项目...');
+
+  try {
+    const templateDir = path.resolve(
+      __dirname,
+      `../template/${templateName}`
+    );
+
+    if (!fs.existsSync(templateDir)) {
+      s.stop('❌ 模板不存在');
+      cancel(`模板目录不存在: ${templateDir}`);
+      process.exit(1);
+    }
+
+    copyDir(templateDir, targetDir);
+    renderTemplates(targetDir, { projectName, needESLint });
+
+    // 如果选择配置 ESLint，则进行配置
+    if (needESLint) {
+      s.message('正在配置 ESLint...');
+      await setupESLint(targetDir, templateName);
+    }
+
+    s.stop('✅ 项目创建成功！');
+
+    // 7. 显示成功信息
+    const startCmd = getStartCommand(templateName, needESLint);
+    let installCmd = `  cd ${projectName}\n  ${startCmd.install}\n`;
+    
+    if (startCmd.lint) {
+      installCmd += `  ${startCmd.lint}\n`;
+    }
+    
+    installCmd += `  ${startCmd.dev}\n`;
+    
+    outro(chalk.green(`\n🎉 项目创建成功！\n\n${installCmd}`));
+  } catch (error) {
+    s.stop('❌ 创建失败');
+    cancel(`创建项目时出错: ${error.message}`);
+    process.exit(1);
+  }
+}

package/src/commands/mcp.js

@@ -0,0 +1,157 @@
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+import fs from "node:fs";
+import chalk from "chalk";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+/**
+ * 查找包根目录（包含 package.json 的目录）
+ */
+function findPackageRoot() {
+  let currentDir = __dirname;
+  const root = path.parse(currentDir).root;
+  
+  while (currentDir !== root) {
+    const packageJsonPath = path.join(currentDir, "package.json");
+    if (fs.existsSync(packageJsonPath)) {
+      return currentDir;
+    }
+    currentDir = path.dirname(currentDir);
+  }
+  
+  // 如果找不到，使用相对路径（开发环境）
+  return path.resolve(__dirname, "../..");
+}
+
+/**
+ * 获取 MCP 服务器配置信息
+ */
+function getMCPConfig() {
+  // 获取包根目录
+  const packageRoot = findPackageRoot();
+  
+  // 获取 MCP 服务器的绝对路径（用于 stdio 传输）
+  // 优先尝试包内的路径，如果不存在则尝试相对路径（开发环境）
+  const mcpServerPathInPackage = path.join(packageRoot, "src/mcp/src/index.js");
+  const mcpServerPathRelative = path.resolve(__dirname, "../mcp/src/index.js");
+  
+  const mcpServerPath = fs.existsSync(mcpServerPathInPackage) 
+    ? mcpServerPathInPackage 
+    : mcpServerPathRelative;
+  
+  // Cursor 使用 stdio 传输，需要 command + args 配置
+  const config = {
+    mcpServers: {
+      "cm-cli": {
+        command: "node",
+        args: [mcpServerPath],
+      },
+    },
+  };
+
+  // 检查依赖（尝试多个可能的位置）
+  const possibleDepsPaths = [
+    path.join(packageRoot, "src/mcp/node_modules/@modelcontextprotocol/sdk"),
+    path.join(packageRoot, "node_modules/@modelcontextprotocol/sdk"),
+    path.resolve(__dirname, "../mcp/node_modules/@modelcontextprotocol/sdk"),
+  ];
+  
+  const depsInstalled = possibleDepsPaths.some(depPath => fs.existsSync(depPath));
+
+  return {
+    config,
+    mcpServerPath,
+    pathExists: fs.existsSync(mcpServerPath),
+    depsInstalled,
+  };
+}
+
+/**
+ * 打印 MCP 配置信息
+ */
+function printConfig() {
+  const { config } = getMCPConfig();
+
+  console.log(chalk.yellow.bold("Cursor MCP 配置 (mcpServers) - stdio 传输:\n"));
+  console.log(chalk.white(JSON.stringify(config, null, 2)));
+  console.log("\n");
+}
+
+/**
+ * 启动 MCP 服务器
+ */
+async function startMCPServer() {
+  const { mcpServerPath, pathExists, depsInstalled } = getMCPConfig();
+
+  if (!pathExists) {
+    console.error(chalk.red(`❌ MCP 服务器文件不存在: ${mcpServerPath}`));
+    process.exit(1);
+  }
+
+  if (!depsInstalled) {
+    console.error(chalk.red("❌ 依赖未安装，请先运行: cd src/mcp && pnpm install"));
+    process.exit(1);
+  }
+
+  try {
+    // 启动 stdio 服务器（用于 Cursor）
+    console.log(chalk.green("🚀 正在启动 MCP stdio 服务器（用于 Cursor）...\n"));
+    
+    const { spawn } = await import("child_process");
+    const stdioProcess = spawn("node", [mcpServerPath], {
+      stdio: "inherit",
+      cwd: path.dirname(mcpServerPath),
+    });
+
+    stdioProcess.on("error", (error) => {
+      console.error(chalk.red(`❌ 启动失败: ${error.message}`));
+      process.exit(1);
+    });
+
+    console.log(chalk.green(`✅ MCP stdio 服务器已启动（用于 Cursor）`));
+    console.log(chalk.gray(`   按 Ctrl+C 停止服务器\n`));
+
+    // 处理退出信号
+    process.on("SIGINT", () => {
+      console.log(chalk.yellow("\n\n正在停止 MCP 服务器..."));
+      stdioProcess.kill();
+      console.log(chalk.green("✅ 服务器已停止"));
+      process.exit(0);
+    });
+
+    process.on("SIGTERM", () => {
+      stdioProcess.kill();
+      process.exit(0);
+    });
+
+    stdioProcess.on("exit", (code) => {
+      if (code !== 0 && code !== null) {
+        console.error(chalk.red(`❌ 服务器异常退出，代码: ${code}`));
+      }
+      process.exit(code || 0);
+    });
+  } catch (error) {
+    console.error(chalk.red(`❌ 启动失败: ${error.message}`));
+    process.exit(1);
+  }
+}
+
+/**
+ * MCP 命令主函数
+ */
+export default async function mcp(options = {}) {
+  // 先打印配置信息
+  printConfig();
+
+  // 如果只是查看配置，不启动服务器
+  if (options.configOnly) {
+    console.log(chalk.gray("💡 提示: 使用 'cm mcp' 可以启动 MCP stdio 服务器（用于 Cursor）\n"));
+    return;
+  }
+
+  // 然后启动服务器
+  await startMCPServer();
+}
+

package/src/mcp/CURSOR_SETUP.md

@@ -0,0 +1,259 @@
+# 在 Cursor 中使用 CM CLI MCP 服务器
+
+本指南将帮助你在 Cursor 中配置和使用 CM CLI MCP 服务器。
+
+## 🚀 快速开始
+
+1. **安装依赖（首次使用必需）**
+   ```bash
+   cd src/mcp
+   pnpm install
+   ```
+   这会安装 MCP SDK 等必要的依赖包。
+
+2. **获取配置信息**
+   ```bash
+   pnpm run get-config
+   ```
+   这会显示你需要的配置信息。
+
+2. **在 Cursor 中配置**
+   - 打开设置 (`Ctrl+,` 或 `Cmd+,`)
+   - 搜索 "MCP"
+   - 添加显示的配置
+
+3. **重启 Cursor**
+
+4. **开始使用**
+   在 Cursor 的 AI 聊天中，你可以说：
+   - "请创建一个 Vue2 后台管理系统项目"
+   - "请查看当前项目的结构树"
+
+## 前置要求
+
+1. 确保已安装 Node.js (v18 或更高版本)
+2. 确保已安装 pnpm：`npm install -g pnpm`
+3. **重要**: 首次使用前必须安装项目依赖：
+   ```bash
+   cd src/mcp
+   pnpm install
+   ```
+   如果遇到依赖问题，可以使用 `pnpm install --force` 强制重新安装。
+
+## 配置步骤
+
+### 方法 1: 通过 Cursor 设置配置（推荐）
+
+1. **打开 Cursor 设置**
+   - 按 `Ctrl+,` (Windows/Linux) 或 `Cmd+,` (Mac) 打开设置
+   - 或者点击左下角齿轮图标 → Settings
+
+2. **找到 MCP 设置**
+   - 在设置搜索框中输入 "MCP" 或 "Model Context Protocol"
+   - 找到 MCP 服务器配置选项
+
+3. **添加 MCP 服务器配置**
+   
+   运行以下命令获取配置：
+   ```bash
+   cm mcp --config-only
+   ```
+   
+   或者手动添加以下内容（JSON 格式）：
+
+   ```json
+   {
+     "mcpServers": {
+       "cm-cli": {
+         "command": "node",
+         "args": [
+           "/path/to/cm-cli/src/mcp/src/index.js"
+         ]
+       }
+     }
+   }
+   ```
+
+   **重要**: 
+   - Cursor 使用 **stdio 传输**，必须使用 `command` + `args` 格式
+   - 请将路径替换为你的实际项目路径
+   - 不需要指定端口，stdio 传输不依赖端口
+
+### 方法 2: 通过配置文件
+
+1. **找到 Cursor 配置文件位置**
+   - Windows: `%APPDATA%\Cursor\User\globalStorage\cursor.mcp\settings.json`
+   - macOS: `~/Library/Application Support/Cursor/User/globalStorage/cursor.mcp/settings.json`
+   - Linux: `~/.config/Cursor/User/globalStorage/cursor.mcp/settings.json`
+
+2. **编辑配置文件**
+
+   如果文件不存在，创建它。添加以下内容：
+
+   ```json
+   {
+     "mcpServers": {
+       "cm-cli": {
+         "command": "node",
+         "args": [
+           "/absolute/path/to/cm-cli/src/mcp/src/index.js"
+         ]
+       }
+     }
+   }
+   ```
+
+3. **重启 Cursor**
+
+   保存配置文件后，重启 Cursor 使配置生效。
+
+## 验证配置
+
+配置完成后，你可以通过以下方式验证：
+
+1. **在 Cursor 中询问 AI**
+   - 打开 Cursor 的 AI 聊天面板
+   - 输入：`请使用 create-project 工具创建一个 Vue2 项目`
+   - 如果配置正确，AI 应该能够调用 MCP 工具
+
+2. **查看可用工具**
+   - 询问 AI：`列出可用的 MCP 工具`
+   - 应该能看到 `create-project` 和 `show-project-tree` 两个工具
+
+## 使用示例
+
+### 示例 1: 创建项目
+
+在 Cursor 的 AI 聊天中，你可以这样请求：
+
+```
+请使用 create-project 工具创建一个名为 "my-admin-app" 的后台管理系统项目，
+使用 Vue2，并配置 ESLint。
+```
+
+AI 会自动调用 MCP 工具并创建项目。
+
+### 示例 2: 查看项目结构
+
+```
+请使用 show-project-tree 工具查看当前项目的结构树，最大深度为 2。
+```
+
+### 示例 3: 创建移动端项目
+
+```
+请创建一个名为 "my-mobile-app" 的移动端项目（Uni-app），不配置 ESLint。
+```
+
+## 路径配置说明
+
+### Windows 路径示例
+```json
+{
+  "args": [
+    "D:\\files\\test\\cli\\cm-cli\\src\\mcp\\src\\index.js"
+  ]
+}
+```
+
+### macOS/Linux 路径示例
+```json
+{
+  "args": [
+    "/Users/username/projects/cm-cli/src/mcp/src/index.js"
+  ]
+}
+```
+
+### 使用相对路径（如果可能）
+
+某些情况下，Cursor 可能支持相对路径，但建议使用绝对路径以确保可靠性。
+
+## 故障排除
+
+### 问题 1: MCP 服务器无法启动
+
+**解决方案**:
+1. 检查 Node.js 是否正确安装：`node --version`
+2. 检查路径是否正确（使用绝对路径）
+3. 检查依赖是否已安装：`cd src/mcp && pnpm install`
+
+### 问题 2: AI 无法识别工具
+
+**解决方案**:
+1. 重启 Cursor
+2. 检查配置文件格式是否正确（JSON 格式）
+3. 查看 Cursor 的开发者工具（如果有）查看错误信息
+
+### 问题 3: 工具执行失败
+
+**解决方案**:
+1. 确保项目路径存在且可访问
+2. 检查文件权限
+3. 查看控制台错误信息
+
+## 高级配置
+
+### 使用环境变量
+
+如果需要设置环境变量，可以在配置中添加：
+
+```json
+{
+  "mcpServers": {
+    "cm-cli": {
+      "command": "node",
+      "args": [
+        "/path/to/cm-cli/src/mcp/src/index.js"
+      ],
+      "env": {
+        "NODE_ENV": "production"
+      }
+    }
+  }
+}
+```
+
+### 使用 npm/pnpm 脚本
+
+如果你想通过 npm 脚本运行，可以创建一个启动脚本：
+
+在 `src/mcp/package.json` 中添加：
+
+```json
+{
+  "scripts": {
+    "start": "node src/index.js"
+  }
+}
+```
+
+然后在 Cursor 配置中使用：
+
+```json
+{
+  "mcpServers": {
+    "cm-cli": {
+      "command": "pnpm",
+      "args": ["--dir", "/path/to/cm-cli/src/mcp", "start"]
+    }
+  }
+}
+```
+
+## 测试 MCP 服务器
+
+在配置之前，你可以先手动测试 MCP 服务器是否正常工作：
+
+```bash
+cd src/mcp
+node src/index.js
+```
+
+如果服务器正常启动，你应该看到类似 "CM CLI MCP 服务器已启动" 的消息。
+
+## 更多信息
+
+- 查看 [README.md](./README.md) 了解工具详细说明
+- 查看 [test-mcp.js](./test-mcp.js) 了解如何测试
+