bmall-mcp 1.0.0

package/README.md

@@ -0,0 +1,80 @@
+# bmall-mcp
+
+MCP Server for bmall development rules and tools.
+
+## Features
+
+- 📋 Sync bmall Rules to IDE directories
+- 🔄 Support for Kiro, Cursor, Windsurf
+- 📦 Easy one-command setup
+
+## Installation
+
+```bash
+npm install
+npm run build
+```
+
+## Usage
+
+### Local Development
+
+```bash
+npm run dev
+```
+
+### In Kiro
+
+Add to `.kiro/settings/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "bmall": {
+      "command": "npx",
+      "args": ["-y", "bmall-mcp"],
+      "env": {}
+    }
+  }
+}
+```
+
+Then restart Kiro and use the `sync_rules` tool:
+
+```
+User: 帮我同步 Rules 到 Kiro
+AI: Calling sync_rules(ide="kiro")
+```
+
+## Project Structure
+
+```
+bmall-mcp/
+├── src/
+│   ├── index.ts           # MCP Server entry
+│   └── tools/
+│       └── sync.ts        # sync_rules implementation
+├── rules/                 # bmall Rules files
+├── package.json
+└── tsconfig.json
+```
+
+## Development
+
+```bash
+# Build
+npm run build
+
+# Run
+npm start
+
+# Dev with ts-node
+npm run dev
+```
+
+## Next Steps
+
+- [ ] Add Resources for component library
+- [ ] Add Git sync functionality
+- [ ] Publish to npm
+- [ ] Create one-click setup script

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,134 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { pullRules } from "./tools/pull.js";
+import { pushRules } from "./tools/push.js";
+import { getGitCommitPrompt } from "./tools/gitPrompt.js";
+const server = new Server({
+    name: "bmall-mcp",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// 注册 Tools
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: "pull_rules",
+            description: "从 Git 下载/克隆 bmall Rules 到 IDE 目录",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    ide: {
+                        type: "string",
+                        enum: ["kiro", "cursor", "windsurf"],
+                        description: "目标 IDE (可选，默认自动检测)",
+                    },
+                    rulesType: {
+                        type: "string",
+                        enum: ["ios", "android", "web", "flutter"],
+                        description: "Rules 类型 (可选，默认自动检测)",
+                    },
+                },
+            },
+        },
+        {
+            name: "push_rules",
+            description: "上传本地修改的 bmall Rules 到 Git",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    message: {
+                        type: "string",
+                        description: "提交信息 (可选)",
+                    },
+                    rulesType: {
+                        type: "string",
+                        enum: ["ios", "android", "web", "flutter"],
+                        description: "Rules 类型 (可选，默认自动检测)",
+                    },
+                },
+            },
+        },
+        {
+            name: "standard_git_commit",
+            description: "规范化 Git 提交：自动分析改动内容，生成符合约定式提交规范的 commit message 并推送",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    scope: {
+                        type: "string",
+                        description: "需求名称，如：语音转写SDK、购物车、登录模块",
+                    },
+                },
+                required: ["scope"],
+            },
+        },
+    ],
+}));
+// 处理 Tool 调用
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    if (request.params.name === "pull_rules") {
+        const ide = request.params.arguments?.ide;
+        const rulesType = request.params.arguments?.rulesType;
+        const result = await pullRules(ide, rulesType);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: result,
+                },
+            ],
+        };
+    }
+    if (request.params.name === "push_rules") {
+        const message = request.params.arguments?.message;
+        const rulesType = request.params.arguments?.rulesType;
+        const result = await pushRules(message, rulesType);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: result,
+                },
+            ],
+        };
+    }
+    if (request.params.name === "standard_git_commit") {
+        const scope = request.params.arguments?.scope;
+        if (!scope) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "❌ 缺少必填参数: scope (需求名称)",
+                    },
+                ],
+            };
+        }
+        const prompt = getGitCommitPrompt(scope);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: prompt,
+                },
+            ],
+        };
+    }
+    throw new Error(`Unknown tool: ${request.params.name}`);
+});
+// 启动服务器
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("[bmall-mcp] Server running on stdio");
+}
+main().catch((error) => {
+    console.error("[bmall-mcp] Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/gitPrompt.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Git 提交规范 Prompt Tool
+ * 返回提示词，让 Agent 按规范执行 git commit
+ */
+export declare function getGitCommitPrompt(scope: string): string;
+//# sourceMappingURL=gitPrompt.d.ts.map

package/dist/tools/gitPrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitPrompt.d.ts","sourceRoot":"","sources":["../../src/tools/gitPrompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA+CxD"}

package/dist/tools/gitPrompt.js

@@ -0,0 +1,53 @@
+/**
+ * Git 提交规范 Prompt Tool
+ * 返回提示词，让 Agent 按规范执行 git commit
+ */
+export function getGitCommitPrompt(scope) {
+    return `# Git 提交任务
+
+## 你的任务
+为需求「${scope}」提交代码到远程仓库。
+
+## 执行步骤
+
+1. **检查状态**: 执行 \`git status\` 查看改动
+2. **查看差异**: 执行 \`git diff\` 分析具体改动内容
+3. **判断类型**: 根据改动内容判断 commit type
+4. **提交推送**: 执行 \`git add . && git commit && git push\`
+
+## Commit Message 格式
+
+\`\`\`
+<type>(${scope}): <描述>
+
+[可选正文]
+\`\`\`
+
+## Type 类型
+
+- **fix**: 修复 bug
+- **feat**: 新增功能
+- **docs**: 文档更新
+- **refactor**: 代码重构
+- **style**: 代码格式调整
+- **perf**: 性能优化
+- **test**: 测试相关
+- **chore**: 构建/工具变动
+
+## 规则
+
+- **[必须]** scope 使用「${scope}」
+- **[必须]** 描述清晰简洁，说明做了什么
+- **[必须]** 根据实际改动判断 type，不要猜测
+- **[建议]** 重要功能添加正文说明改动细节
+
+## 示例
+
+\`\`\`bash
+git commit -m "feat(${scope}): 添加语音录制功能"
+git commit -m "fix(${scope}): 修复登录失败问题"
+\`\`\`
+
+现在请执行任务。`;
+}
+//# sourceMappingURL=gitPrompt.js.map

package/dist/tools/gitPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitPrompt.js","sourceRoot":"","sources":["../../src/tools/gitPrompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO;;;MAGH,KAAK;;;;;;;;;;;;SAYF,KAAK;;;;;;;;;;;;;;;;;;sBAkBQ,KAAK;;;;;;;;sBAQL,KAAK;qBACN,KAAK;;;SAGjB,CAAC;AACV,CAAC"}

package/dist/tools/pull.d.ts

@@ -0,0 +1,2 @@
+export declare function pullRules(ide?: string, rulesType?: string): Promise<string>;
+//# sourceMappingURL=pull.d.ts.map

package/dist/tools/pull.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../src/tools/pull.ts"],"names":[],"mappings":"AAYA,wBAAsB,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA8CjF"}

package/dist/tools/pull.js

@@ -0,0 +1,43 @@
+import * as path from "path";
+import * as fs from "fs";
+import { RULES_CACHE_DIR, log, validateAndGetRulesType, validateAndGetIDE, fetchRulesFromGit, copyMarkdownFiles, getGitRulesDir, } from "./utils.js";
+export async function pullRules(ide, rulesType) {
+    try {
+        // 验证并获取 Rules 类型
+        const typeResult = validateAndGetRulesType(rulesType);
+        if (typeResult.error) {
+            return typeResult.error;
+        }
+        const projectType = typeResult.type;
+        // 验证并获取 IDE
+        const ideResult = validateAndGetIDE(ide);
+        if (ideResult.error) {
+            return ideResult.error;
+        }
+        const targetPath = ideResult.path;
+        // 确保父目录存在
+        fs.mkdirSync(targetPath, { recursive: true });
+        // 目标路径包含项目类型文件夹（如 .kiro/steering/bmall/iOS/）
+        const rulesTypeDir = getGitRulesDir(projectType);
+        const targetRulesTypeDir = path.join(targetPath, rulesTypeDir);
+        log(`Fetching rules from git...`);
+        const rulesSourceDir = await fetchRulesFromGit(projectType);
+        log(`Copying files to ${targetRulesTypeDir}...`);
+        // 直接覆盖，不备份（Git 本身有版本管理）
+        const result = copyMarkdownFiles(rulesSourceDir, targetRulesTypeDir, { backup: false });
+        if (result.count === 0) {
+            return `⚠️ 未找到任何 Markdown 文件\n源目录: ${rulesSourceDir}`;
+        }
+        return `✅ 下载完成！
+Rules 类型: ${projectType}
+IDE: ${ideResult.ide}
+目标目录: ${targetRulesTypeDir}
+复制文件数: ${result.count}
+缓存目录: ${RULES_CACHE_DIR}`;
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        return `❌ 下载失败: ${errorMsg}`;
+    }
+}
+//# sourceMappingURL=pull.js.map

package/dist/tools/pull.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.js","sourceRoot":"","sources":["../../src/tools/pull.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EACL,eAAe,EACf,GAAG,EACH,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAY,EAAE,SAAkB;IAC9D,IAAI,CAAC;QACH,iBAAiB;QACjB,MAAM,UAAU,GAAG,uBAAuB,CAAC,SAAS,CAAC,CAAC;QACtD,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;YACrB,OAAO,UAAU,CAAC,KAAK,CAAC;QAC1B,CAAC;QACD,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC;QAEpC,YAAY;QACZ,MAAM,SAAS,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;YACpB,OAAO,SAAS,CAAC,KAAK,CAAC;QACzB,CAAC;QAED,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC;QAElC,UAAU;QACV,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE9C,6CAA6C;QAC7C,MAAM,YAAY,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;QACjD,MAAM,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAE/D,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAClC,MAAM,cAAc,GAAG,MAAM,iBAAiB,CAAC,WAAW,CAAC,CAAC;QAE5D,GAAG,CAAC,oBAAoB,kBAAkB,KAAK,CAAC,CAAC;QACjD,wBAAwB;QACxB,MAAM,MAAM,GAAG,iBAAiB,CAAC,cAAc,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAExF,IAAI,MAAM,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,8BAA8B,cAAc,EAAE,CAAC;QACxD,CAAC;QAED,OAAO;YACC,WAAW;OAChB,SAAS,CAAC,GAAG;QACZ,kBAAkB;SACjB,MAAM,CAAC,KAAK;QACb,eAAe,EAAE,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,QAAQ,GACZ,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACzD,OAAO,WAAW,QAAQ,EAAE,CAAC;IAC/B,CAAC;AACH,CAAC"}

package/dist/tools/push.d.ts

@@ -0,0 +1,2 @@
+export declare function pushRules(message?: string, rulesType?: string): Promise<string>;
+//# sourceMappingURL=push.d.ts.map

package/dist/tools/push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../src/tools/push.ts"],"names":[],"mappings":"AAiBA,wBAAsB,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA6GrF"}

package/dist/tools/push.js

@@ -0,0 +1,93 @@
+import * as fs from "fs";
+import * as path from "path";
+import { GIT_BRANCH, RULES_CACHE_DIR, log, validateAndGetRulesType, validateAndGetIDE, detectProjectName, getGitRulesDir, copyMarkdownFiles, initializeGitCache, setupSparseCheckout, checkoutOrCreateBranch, } from "./utils.js";
+import { execSync } from "child_process";
+export async function pushRules(message, rulesType) {
+    try {
+        // 验证并获取 Rules 类型
+        const typeResult = validateAndGetRulesType(rulesType);
+        if (typeResult.error) {
+            return typeResult.error;
+        }
+        const projectType = typeResult.type;
+        // 验证并获取 IDE
+        const ideResult = validateAndGetIDE();
+        if (ideResult.error) {
+            return ideResult.error;
+        }
+        // 检测项目名称，用于创建项目级分支
+        const projectName = detectProjectName();
+        const projectBranch = `project/${projectName}`;
+        const localRulesPath = ideResult.path;
+        // 验证本地 Rules 目录
+        if (!fs.existsSync(localRulesPath)) {
+            return `❌ 本地 Rules 目录不存在: ${localRulesPath}`;
+        }
+        // 本地 Rules 目录中的项目类型文件夹（如 .kiro/steering/bmall/iOS/）
+        const localRulesTypeDir = path.join(localRulesPath, getGitRulesDir(projectType));
+        if (!fs.existsSync(localRulesTypeDir)) {
+            return `❌ 本地 Rules 类型目录不存在: ${localRulesTypeDir}\n请先运行 pull_rules 下载 Rules`;
+        }
+        log(`项目名称: ${projectName}`);
+        log(`项目分支: ${projectBranch}`);
+        log(`本地 Rules 类型目录: ${localRulesTypeDir}`);
+        // 初始化缓存仓库
+        initializeGitCache();
+        // 设置 sparse-checkout
+        const rulesDir = getGitRulesDir(projectType);
+        setupSparseCheckout(rulesDir);
+        // 拉取最新代码
+        log(`拉取最新代码...`);
+        execSync(`git -C ${RULES_CACHE_DIR} fetch origin`, {
+            stdio: "inherit",
+        });
+        // 检出或创建项目分支
+        checkoutOrCreateBranch(projectBranch);
+        // 复制本地修改到缓存仓库
+        const cacheRulesTypeDir = path.join(RULES_CACHE_DIR, rulesDir);
+        log(`复制本地修改到缓存仓库...`);
+        // 清空缓存目录中的旧文件
+        if (fs.existsSync(cacheRulesTypeDir)) {
+            fs.rmSync(cacheRulesTypeDir, { recursive: true, force: true });
+        }
+        // 复制时不需要备份（覆盖缓存目录）
+        const result = copyMarkdownFiles(localRulesTypeDir, cacheRulesTypeDir, { backup: false });
+        log(`复制文件数: ${result.count}`);
+        // 检查是否有修改
+        log(`检查修改...`);
+        const status = execSync(`git -C ${RULES_CACHE_DIR} status --porcelain`, {
+            encoding: "utf-8",
+        });
+        if (!status.trim()) {
+            return `⚠️ 没有检测到修改`;
+        }
+        // 添加修改
+        log(`添加修改...`);
+        execSync(`git -C ${RULES_CACHE_DIR} add -A`, { stdio: "inherit" });
+        // 提交修改
+        const commitMessage = message || `chore(${projectType}): 更新 Rules`;
+        log(`提交修改: ${commitMessage}`);
+        execSync(`git -C ${RULES_CACHE_DIR} commit -m "${commitMessage}"`, {
+            stdio: "inherit",
+        });
+        // 推送到远程
+        log(`推送到远程分支 ${projectBranch}...`);
+        execSync(`git -C ${RULES_CACHE_DIR} push -u origin ${projectBranch}`, {
+            stdio: "inherit",
+        });
+        return `✅ 上传完成！
+项目名称: ${projectName}
+Rules 类型: ${projectType}
+项目分支: ${projectBranch}
+提交信息: ${commitMessage}
+修改文件数: ${result.count}
+
+💡 提示: 修改已推送到项目分支，不会影响主分支 (${GIT_BRANCH})
+可以通过 Pull Request 将改动合并到主分支`;
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        return `❌ 上传失败: ${errorMsg}`;
+    }
+}
+//# sourceMappingURL=push.js.map

package/dist/tools/push.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.js","sourceRoot":"","sources":["../../src/tools/push.ts"],"names":[],"mappings":"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"}

package/dist/tools/sync.d.ts

@@ -0,0 +1,2 @@
+export declare function syncRules(ide?: string, rulesType?: string): Promise<string>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/tools/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/tools/sync.ts"],"names":[],"mappings":"AA8RA,wBAAsB,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqDjF"}