mcp-state-machine-test-framework 1.0.8 → 1.1.0

package/README.md

@@ -40,5 +40,13 @@ This framework enforces a "Strict Contract" via MCP tools. Agents are instructed
 - [📱 Perfecto Mobile Cloud Setup](./DOCUMENTATION/Perfecto_Setup.md)
 - [🤖 Agent Guidelines](./agent_protocol.md)
 
+## 🤖 AI Agent Quickstart (For Copilot/Cursor/Antigravity)
+If you are an AI agent helping with this project, follow these rules:
+1. **Environment**: This is a Node.js project. Always use `npm`.
+2. **Setup**: Install via `npm install mcp-state-machine-test-framework`.
+3. **Configuration**: Use `npx mcp-sms` as the command in `mcp_config.json`.
+4. **Initialization**: Your very first action after installation **MUST** be calling the `init_project` tool to create the directory structure and templates.
+5. **Workflow**: Use `inspect_framework` to understand the current state before proposing changes.
+
 ---
 *Developed with ❤️ for maximum automation efficiency.*

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.8",
+  "version": "1.1.0",
   "description": "High-fidelity State Machine MCP Server for autonomous E2E testing orchestration.",
   "main": "index.js",
   "type": "module",