feat: --rule args (#5)

Author: Seann0824

README.zh-CN.md

@@ -22,6 +22,25 @@ MasterGo Magic MCP 是一个独立的 MCP（Model Context Protocol）服务，
 4. 找到个人访问令牌
 5. 点击生成令牌
 
+### 命令行选项
+
+```
+npx @mastergo/magic-mcp --token=YOUR_TOKEN [--url=API_URL] [--rule=RULE_NAME] [--debug]
+```
+
+#### 参数:
+
+- `--token=YOUR_TOKEN` (必需): MasterGo API 认证令牌
+- `--url=API_URL` (可选): API 基础 URL，默认为 http://localhost:3000
+- `--rule=RULE_NAME` (可选): 添加要应用的设计规则，可多次使用
+- `--debug` (可选): 启用调试模式，提供详细错误信息
+
+你也可以使用空格分隔的参数格式:
+
+```
+npx @mastergo/magic-mcp --token YOUR_TOKEN --url API_URL --rule RULE_NAME --debug
+```
+
 ### Cursor 使用方法
 
 Cursor Mcp 使用指南参考：https://docs.cursor.com/context/model-context-protocol#using-mcp-tools-in-agent
@@ -64,4 +83,4 @@ Cursor Mcp 使用指南参考：https://docs.cursor.com/context/model-context-pr
 
 ## 许可证
 
-ISC 
+ISC

bin/cli.js

@@ -9,6 +9,8 @@ const args = process.argv.slice(2);
 let token = "";
 let baseUrl = "http://localhost:3000";
 let debug = false;
+// Array to collect rules
+let rules = [];
 
 // Parse arguments
 for (let i = 0; i < args.length; i++) {
@@ -24,14 +26,20 @@ for (let i = 0; i < args.length; i++) {
     baseUrl = args[i].split("=")[1];
   } else if (args[i] === "--debug") {
     debug = true;
+    // Add support for --rule parameter
+  } else if (args[i] === "--rule" && i + 1 < args.length) {
+    rules.push(args[i + 1]);
+    i++;
+  } else if (args[i].startsWith("--rule=")) {
+    rules.push(args[i].split("=")[1]);
   }
 }
 
 // Check required arguments
 if (!token) {
   console.error("Error: Missing MasterGo API Token");
   console.error(
-    "Usage: npx mastergo-magic-mcp --token=YOUR_TOKEN [--url=API_URL]"
+    "Usage: npx mastergo-magic-mcp --token=YOUR_TOKEN [--url=API_URL] [--rule=RULE_NAME]"
   );
   console.error("Use --help or -h for more information");
   process.exit(1);
@@ -43,6 +51,8 @@ const env = {
   MASTERGO_API_TOKEN: token,
   API_BASE_URL: baseUrl,
   DEBUG: debug ? "true" : "false",
+  // Add RULES environment variable as stringified array
+  RULES: JSON.stringify(rules),
 };
 
 // Get package path
@@ -51,7 +61,9 @@ const indexPath = path.join(packageDir, "index.js");
 
 // Check if file exists
 if (!fs.existsSync(indexPath)) {
-  console.error("Error: Executable file not found. Please ensure the package is correctly installed.");
+  console.error(
+    "Error: Executable file not found. Please ensure the package is correctly installed."
+  );
   process.exit(1);
 }
 
@@ -60,6 +72,7 @@ if (debug) {
   console.log(`Package path: ${indexPath}`);
   console.log(`Token: ${token ? "set" : "not set"}`);
   console.log(`API URL: ${baseUrl}`);
+  console.log(`Rules: ${rules.length > 0 ? rules.join(", ") : "none"}`);
   console.log(`Debug mode: ${debug ? "enabled" : "disabled"}`);
 }
 

readme.md

@@ -22,6 +22,25 @@ MasterGo Magic MCP is a standalone MCP (Model Context Protocol) service designed
 4. Find the personal access token
 5. Click to generate the token
 
+### Command Line Options
+
+```
+npx @mastergo/magic-mcp --token=YOUR_TOKEN [--url=API_URL] [--rule=RULE_NAME] [--debug]
+```
+
+#### Parameters:
+
+- `--token=YOUR_TOKEN` (required): MasterGo API token for authentication
+- `--url=API_URL` (optional): API base URL, defaults to http://localhost:3000
+- `--rule=RULE_NAME` (optional): Add design rules to apply, can be used multiple times
+- `--debug` (optional): Enable debug mode for detailed error information
+
+You can also use space-separated format for parameters:
+
+```
+npx @mastergo/magic-mcp --token YOUR_TOKEN --url API_URL --rule RULE_NAME --debug
+```
+
 ### cursor Usage
 
 Cursor Mcp usage guide reference: https://docs.cursor.com/context/model-context-protocol#using-mcp-tools-in-agent

src/http-util.ts

@@ -111,6 +111,7 @@ export class HttpUtil {
                 }
               \`\`\`
           `,
+          ...(JSON.parse(process.env.RULES ?? "[]") as string[]),
         ],
       };
       return result;