mcp-state-machine-test-framework 1.0.9 → 1.1.1

package/.mcp_agent_rules

@@ -0,0 +1,20 @@
+# 🤖 Rules for AI Agents (Copilot, Cursor, etc.)
+
+## 🚀 Environment & Tools
+- This is a **Node.js** project using **npm**.
+- You have **FULL PERMISSION** to execute terminal commands and create/modify files.
+- The primary framework is `mcp-state-machine-test-framework`.
+
+## 🛠️ Mandatory Workflow
+1. **Never ask for language or setup details**: Read `package.json` and `README.md` first.
+2. **Initialization**: If folders are missing, run the `init_project` tool immediately.
+3. **Structured Design**: DO NOT edit JSON files in `/maps`, `/suites`, or `/test_cases` directly. ALWAYS use the provided MCP tools (`upsert_node`, `save_test_case`, `save_suite`).
+4. **Validation**: Use `inspect_framework` to verify integrity before finalizing any task.
+
+## 🏁 How to Start
+- Run `npm install mcp-state-machine-test-framework` if not present.
+- Configure `mcp_config.json` in the root.
+- Use `npx mcp-cli --help` to understand CLI usage if needed.
+
+---
+*Follow these rules to ensure high-fidelity automation.*

package/mcp_cli.js

@@ -8,9 +8,32 @@ import { fileURLToPath } from "url";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 async function run() {
-    const args = process.argv.slice(2);
+    let args = process.argv.slice(2);
+    
+    // Soporte para --help
+    if (args.includes("--help") || args.length === 0) {
+        console.log(`
+🚀 MCP CLI Client - State Machine Test Framework
+Uso: mcp-cli <server-name> <tool-name> [json-args] [--config path/to/config.json]
+
+Ejemplos:
+  npx mcp-cli mcp-sms init_project
+  npx mcp-cli mcp-sms execute_suite '{"name":"Sanity"}'
+  npx mcp-cli mcp-sms upsert_node '{"mapName":"map.json", "nodeName":"HOME", "nodeData":{}}' --config my_custom_config.json
+        `);
+        process.exit(0);
+    }
+
+    // Extraer --config si existe
+    let configPath = path.join(process.cwd(), "mcp_config.json");
+    const configIdx = args.indexOf("--config");
+    if (configIdx !== -1) {
+        configPath = path.resolve(args[configIdx + 1]);
+        args.splice(configIdx, 2); // Quitar --config y su valor de los argumentos
+    }
+
     if (args.length < 2) {
-        console.error("Uso: mcp-cli <server-name> <tool-name> [json-args]");
+        console.error("❌ Error: Faltan argumentos. Usa --help para ver el uso correcto.");
         process.exit(1);
     }
 
@@ -20,11 +43,14 @@ async function run() {
     // Cargar config
     let config;
     try {
-        const configPath = path.join(process.cwd(), "mcp_config.json");
         const content = await fs.readFile(configPath, "utf8");
-        config = JSON.parse(content).mcpServers[serverName];
+        const fullConfig = JSON.parse(content);
+        config = (fullConfig.mcpServers && fullConfig.mcpServers[serverName]) || fullConfig[serverName];
+        
+        if (!config) throw new Error(`El servidor '${serverName}' no está en la configuración.`);
     } catch (e) {
-        console.error(`❌ No se encontró la configuración para el servidor '${serverName}' en mcp_config.json`);
+        console.error(`❌ Error de configuración: ${e.message}`);
+        console.error(`Ruta buscada: ${configPath}`);
         process.exit(1);
     }
 
@@ -38,12 +64,12 @@ async function run() {
     const client = new Client({ name: "mcp-cli-client", version: "1.0.0" }, { capabilities: {} });
     await client.connect(transport);
 
-    console.error(`🚀 Ejecutando herramienta: ${toolName}`);
+    console.error(`🚀 Ejecutando: ${toolName}`);
     try {
         const result = await client.callTool({ name: toolName, arguments: toolArgs });
         console.log(JSON.stringify(result, null, 2));
     } catch (error) {
-        console.error(`❌ Error ejecutando herramienta: ${error.message}`);
+        console.error(`❌ Error: ${error.message}`);
     } finally {
         process.exit(0);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-state-machine-test-framework",
-  "version": "1.0.9",
+  "version": "1.1.1",
   "description": "High-fidelity State Machine MCP Server for autonomous E2E testing orchestration.",
   "main": "index.js",
   "type": "module",