@reus-able/frontend-helper-mcp 1.0.10 → 1.0.12

package/dist/index.js

@@ -1,41 +1,90 @@
 #!/usr/bin/env node
-import { McpServer as d } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport as f } from "@modelcontextprotocol/sdk/server/stdio.js";
-import c from "fs/promises";
-import s from "path";
-import { fileURLToPath as w } from "url";
-import { ListPromptsRequestSchema as y, GetPromptRequestSchema as h, ListResourcesRequestSchema as R, ReadResourceRequestSchema as v, ListToolsRequestSchema as g, CallToolRequestSchema as S } from "@modelcontextprotocol/sdk/types.js";
-async function m(e) {
+import { McpServer as R } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport as v } from "@modelcontextprotocol/sdk/server/stdio.js";
+import i from "fs/promises";
+import a from "path";
+import { fileURLToPath as d } from "url";
+import { ListPromptsRequestSchema as h, GetPromptRequestSchema as P, ListResourcesRequestSchema as S, ReadResourceRequestSchema as g, ListToolsRequestSchema as F, CallToolRequestSchema as M } from "@modelcontextprotocol/sdk/types.js";
+import q from "fs";
+function x(r) {
   try {
-    return await c.access(e), (await c.readdir(e)).filter(
-      (o) => [".txt", ".md", ".json"].includes(s.extname(o).toLowerCase())
+    return q.statSync(r).isDirectory();
+  } catch {
+    return !1;
+  }
+}
+function p(r, e, o = 8) {
+  let t = r;
+  for (let n = 0; n <= o; n++) {
+    const s = a.resolve(t, e);
+    if (x(s)) return s;
+    const c = a.dirname(t);
+    if (c === t) break;
+    t = c;
+  }
+}
+function l() {
+  const r = process.env.MCP_COMMAND_PROMPTS_DIR ?? process.env.MCP_PROMPTS_DIR;
+  if (r) return r;
+  const e = a.dirname(d(import.meta.url)), o = p(
+    e,
+    "resources/command-prompts"
+  );
+  if (o) return o;
+  const t = p(
+    process.cwd(),
+    "resources/command-prompts"
+  );
+  return t || a.resolve(process.cwd(), "resources/command-prompts");
+}
+async function m(r) {
+  try {
+    return await i.access(r), (await i.readdir(r)).filter(
+      (o) => [".txt", ".md", ".json"].includes(a.extname(o).toLowerCase())
     );
-  } catch (r) {
-    return console.error(`Error accessing prompts directory ${e}:`, r), [];
+  } catch (e) {
+    return console.error(`Error accessing prompts directory ${r}:`, e), [];
   }
 }
-async function u(e, r) {
-  return (await m(e)).find((t) => s.parse(t).name === r);
+async function f(r, e) {
+  return (await m(r)).find((t) => a.parse(t).name === e);
 }
-function p(e) {
-  const r = s.extname(e).toLowerCase();
-  return r === ".md" ? "text/markdown" : r === ".json" ? "application/json" : "text/plain";
+function u(r) {
+  const e = a.extname(r).toLowerCase();
+  return e === ".md" ? "text/markdown" : e === ".json" ? "application/json" : "text/plain";
 }
-function q(e) {
-  const r = s.resolve(__dirname, "../../../resources/command-prompts");
-  e.server.setRequestHandler(y, async () => {
+const w = {
+  "code-refactor.md": {
+    name: "代码重构",
+    description: "对代码进行结构调整，不改变功能逻辑"
+  },
+  "git-commit.md": {
+    name: "Git提交",
+    description: "符合约定式提交格式的Git提交"
+  },
+  "component-refactor.md": {
+    name: "组件重构",
+    description: "对组件进行结构调整，不改变功能逻辑"
+  }
+};
+function C(r) {
+  const e = l();
+  r.server.setRequestHandler(h, async () => {
     try {
-      return { prompts: (await m(r)).map((n) => ({
-        name: s.parse(n).name,
-        description: `Content of ${n}`
-      })) };
+      return { prompts: (await m(e)).map((n) => {
+        const s = a.parse(n).name;
+        return {
+          name: s,
+          description: w[s]?.description || `Content of ${n}`
+        };
+      }) };
     } catch (o) {
       return console.error("Error listing prompts:", o), { prompts: [] };
     }
-  }), e.server.setRequestHandler(h, async (o) => {
+  }), r.server.setRequestHandler(P, async (o) => {
     const t = o.params.name;
     try {
-      const n = await u(r, t);
+      const n = await f(e, t);
       if (!n)
         throw new Error(`Prompt not found: ${t}`);
       return {
@@ -44,7 +93,7 @@ function q(e) {
             role: "user",
             content: {
               type: "text",
-              text: await c.readFile(s.join(r, n), "utf-8")
+              text: await i.readFile(a.join(e, n), "utf-8")
             }
           }
         ]
@@ -54,59 +103,59 @@ function q(e) {
     }
   });
 }
-function x(e) {
-  const r = s.resolve(__dirname, "../../../resources/command-prompts");
-  e.server.setRequestHandler(R, async () => {
+function T(r) {
+  const e = l();
+  r.server.setRequestHandler(S, async () => {
     try {
-      return { resources: (await m(r)).map((n) => {
-        const a = s.parse(n).name, i = p(n);
+      return { resources: (await m(e)).map((n) => {
+        const s = a.parse(n).name, c = u(n);
         return {
-          uri: `prompt://${a}`,
-          name: a,
-          mimeType: i,
-          description: `Content of ${n}`
+          uri: `prompt://${s}`,
+          name: s,
+          mimeType: c,
+          description: w[s]?.description || `Content of ${n}`
         };
       }) };
     } catch (o) {
       return console.error("Error listing resources:", o), { resources: [] };
     }
-  }), e.server.setRequestHandler(
-    v,
+  }), r.server.setRequestHandler(
+    g,
     async (o) => {
       const t = o.params.uri, n = t.replace(/^prompt:\/\//, "");
       try {
-        const a = await u(r, n);
-        if (!a)
+        const s = await f(e, n);
+        if (!s)
           throw new Error(`Resource not found: ${t}`);
-        const i = await c.readFile(s.join(r, a), "utf-8"), l = p(a);
+        const c = await i.readFile(a.join(e, s), "utf-8"), y = u(s);
         return {
           contents: [
             {
               uri: t,
-              mimeType: l,
-              text: i
+              mimeType: y,
+              text: c
             }
           ]
         };
-      } catch (a) {
-        throw new Error(`Failed to read resource ${t}: ${a}`);
+      } catch (s) {
+        throw new Error(`Failed to read resource ${t}: ${s}`);
       }
     }
   );
 }
-function F(e) {
-  e.server.setRequestHandler(g, async () => ({ tools: [] })), e.server.setRequestHandler(S, async (r) => ({
+function $(r) {
+  r.server.setRequestHandler(F, async () => ({ tools: [] })), r.server.setRequestHandler(M, async (e) => ({
     content: [
       {
         type: "text",
-        text: `Tool not found: ${r.params.name}`
+        text: `Tool not found: ${e.params.name}`
       }
     ],
     isError: !0
   }));
 }
-async function $() {
-  const e = s.dirname(w(import.meta.url)), r = s.resolve(e, "../package.json"), o = JSON.parse(await c.readFile(r, "utf-8")), t = new d(
+async function D() {
+  const r = a.dirname(d(import.meta.url)), e = a.resolve(r, "../package.json"), o = JSON.parse(await i.readFile(e, "utf-8")), t = new R(
     {
       name: o.name,
       version: o.version
@@ -119,13 +168,13 @@ async function $() {
       }
     }
   );
-  return q(t), x(t), F(t), t;
+  return C(t), T(t), $(t), t;
 }
 async function H() {
   console.error("Starting MCP server serving...");
-  const e = await $(), r = new f();
-  await e.connect(r);
+  const r = await D(), e = new v();
+  await r.connect(e);
 }
-H().catch((e) => {
-  console.error("Fatal error:", e), process.exit(1);
+H().catch((r) => {
+  console.error("Fatal error:", r), process.exit(1);
 });

package/package.json

@@ -1,7 +1,7 @@
 {
   "description": "前端开发的一些cursor mcp工具集",
   "name": "@reus-able/frontend-helper-mcp",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "publishConfig": {
     "access": "public"
   },
@@ -29,6 +29,7 @@
   "scripts": {
     "build": "vite build && node -e \"require('fs').chmodSync('dist/index.js',0o755)\"",
     "typecheck": "tsc -p tsconfig.json --noEmit",
+    "verify:prompts": "node scripts/verify-command-prompts-path.mjs",
     "test": "echo \"Error: no test specified\" && exit 1"
   }
 }

package/resources/base-prompts/base.md

@@ -0,0 +1,5 @@
+# 项目通用规则
+
+- 始终使用中文回复用户，但技术专有名词可保留英文（如 API、Python、DTO等）。
+- 使用项目既有风格，不引入新风格，包括代码、文档或交互，默认延用项目中已有的格式、缩进、命名习惯。
+- 尽可能少地输出内容，仅提供高信息密度回复，禁止无效寒暄、过度铺垫，只输出对当前任务有直接帮助的信息。

package/resources/command-prompts/git-commit.md

@@ -1,10 +1,46 @@
 ## 协助用户提交当前变更
 
-请你帮助用户提交当前变更，并按照约定式 commit 规范进行 git commit
-你只需要分析用户的变更并生成commit message并commit
-
-要求：
-1. 一般情况下不允许改动任何要提交的文件
-2. 不需要手动跑lint指令，husky会处理
-3. 有时提交可能会报错，你需要分析报错原因并告知用户是否进行下一步操作，如果需要改动文件（例如修复lint错误，类型错误），需要获得用户同意后进行改动
-4. 如果改动了文件，需要告知用户哪里有改动，并且在用户确认后再提交
+# 代码提交规范
+创建格式规范的提交记录，搭配约定式提交信息。
+
+## 功能特性
+- 默认执行提交前检查（代码检查、项目构建、文档生成）
+- 若未暂存任何文件，则自动暂存合适的文件
+- 采用约定式提交格式
+- 针对不同类型的修改，建议拆分提交记录
+
+## 提交类型
+- feat: 新功能
+- fix: 缺陷修复
+- docs: 文档内容变更
+- refactor: 代码重构（不改变功能逻辑）
+- style: 代码格式调整（如补充分号等格式问题）
+- perf: 性能优化
+- test: 新增或修正测试用例
+- chore: 工具配置、项目维护等杂项工作
+- wip: 进行中的工作（未完成提交）
+- remove: 移除代码或文件
+- hotfix: 紧急缺陷修复
+- security: 安全性优化
+
+## 执行流程
+1. 检查已暂存的文件变更（执行 `git status` 命令）
+2. 若未暂存任何文件，则筛选并暂存相关文件
+3. 执行提交前检查（使用 `--no-verify` 参数时跳过）
+4. 分析文件变更内容，确定对应的提交类型
+5. 生成描述清晰的提交信息
+6. 若适用，添加作用域信息，格式为：`提交类型(作用域): 描述内容`
+7. 对于复杂的变更，在提交正文部分说明修改原因
+8. 执行提交操作
+
+## 最佳实践
+- 保持提交的原子化与目标聚焦（一个提交对应一个功能/问题）
+- 提交信息使用祈使语气（例如用“新增功能”而非“已新增功能”）
+- 说明修改的**原因**，而不只是修改的**内容**
+- 涉及相关需求单/合并请求时，添加对应的引用链接或编号
+- 将不相关的代码变更拆分为多个独立的提交
+
+## 关键要求
+**你只需要处理commit操作**
+**在任何情况下不要修改任何文件**
+**如果提交出错，你只需要分析原因并告知用户，不要尝试修复**