@stellisoft/stellify-mcp 0.1.5 → 0.1.7

package/dist/index.js

@@ -1058,6 +1058,88 @@ For PERSISTENT changes (saved to database), use update_element or html_to_elemen
             required: ['action'],
         },
     },
+    {
+        name: 'run_code',
+        description: `Execute code in the Stellify project environment and return the output.
+
+This tool allows you to run PHP or JavaScript code and see the results. Use this for:
+- Testing methods you've created
+- Verifying code behavior
+- Running artisan commands
+- Debugging issues
+- Getting real feedback on code execution
+
+EXECUTION MODES:
+
+1. Run a specific method by UUID:
+   { file: "file-uuid", method: "method-uuid", args: ["arg1", "arg2"] }
+
+2. Run arbitrary PHP code:
+   { code: "return 1 + 1;" }
+
+3. Run with benchmarking enabled:
+   { file: "file-uuid", method: "method-uuid", benchmark: true }
+
+EXAMPLES:
+
+Run a controller method:
+{
+  "file": "user-controller-uuid",
+  "method": "index-method-uuid",
+  "args": []
+}
+
+Execute inline PHP:
+{
+  "code": "return collect([1, 2, 3])->sum();"
+}
+
+Test with benchmark timing:
+{
+  "file": "file-uuid",
+  "method": "method-uuid",
+  "benchmark": true
+}
+
+RESPONSE includes:
+- output: The return value or printed output
+- success: Whether execution succeeded
+- error: Error message if failed
+- execution_time: Time taken (if benchmark enabled)
+- memory_usage: Memory used (if benchmark enabled)
+
+SECURITY: Code runs in a sandboxed environment with limited permissions.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                file: {
+                    type: 'string',
+                    description: 'UUID of the file containing the method to run',
+                },
+                method: {
+                    type: 'string',
+                    description: 'UUID of the method to execute',
+                },
+                code: {
+                    type: 'string',
+                    description: 'Raw PHP/JS code to execute (alternative to file/method)',
+                },
+                args: {
+                    type: 'array',
+                    description: 'Arguments to pass to the method',
+                    items: {},
+                },
+                timeout: {
+                    type: 'number',
+                    description: 'Execution timeout in seconds (default: 30, max: 60)',
+                },
+                benchmark: {
+                    type: 'boolean',
+                    description: 'Enable benchmarking to measure execution time and memory usage',
+                },
+            },
+        },
+    },
 ];
 // Server instructions for tool discovery (used by MCP Tool Search)
 const SERVER_INSTRUCTIONS = `Stellify is a coding platform where you code alongside AI on a codebase maintained and curated by AI. Build Laravel/PHP and Vue.js applications.
@@ -1627,6 +1709,29 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     ],
                 };
             }
+            case 'run_code': {
+                const result = await stellify.runCode(args);
+                const benchmarkInfo = args.benchmark
+                    ? ` (${result.execution_time || 'N/A'}ms, ${result.memory_usage || 'N/A'})`
+                    : '';
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: result.success !== false,
+                                message: result.success !== false
+                                    ? `Code executed successfully${benchmarkInfo}`
+                                    : `Execution failed: ${result.error || 'Unknown error'}`,
+                                output: result.output,
+                                error: result.error,
+                                execution_time: result.execution_time,
+                                memory_usage: result.memory_usage,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
             default:
                 throw new Error(`Unknown tool: ${name}`);
         }

package/dist/stellify-client.d.ts

@@ -148,4 +148,11 @@ export declare class StellifyClient {
             changes: Record<string, any>;
         }>;
     }): Promise<any>;
+    runCode(params: {
+        file: string;
+        method: string;
+        args?: any[];
+        timeout?: number;
+        benchmark?: boolean;
+    }): Promise<any>;
 }

package/dist/stellify-client.js

@@ -174,4 +174,10 @@ export class StellifyClient {
         const response = await this.client.post('/elements/command', params);
         return response.data;
     }
+    // Code execution
+    async runCode(params) {
+        const { file, method, ...body } = params;
+        const response = await this.client.put(`/code/${file}/${method}`, body);
+        return response.data;
+    }
 }

package/manifest.json

@@ -63,7 +63,9 @@
     {"name": "get_module", "description": "Get module with all files"},
     {"name": "create_module", "description": "Create new module for grouping globals"},
     {"name": "add_file_to_module", "description": "Add file to module"},
-    {"name": "install_module", "description": "Install entire module into project"}
+    {"name": "install_module", "description": "Install entire module into project"},
+    {"name": "broadcast_element_command", "description": "Broadcast real-time UI updates via WebSocket"},
+    {"name": "run_code", "description": "Execute code and return output with optional benchmarking"}
   ],
   "tools_generated": false,
   "compatibility": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stellisoft/stellify-mcp",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "mcpName": "io.github.MattStellisoft/stellify-mcp",
   "description": "MCP server for Stellify - AI-native code generation platform",
   "main": "dist/index.js",