@iyulab/mloop-mcp 0.1.0

package/README.md

@@ -0,0 +1,178 @@
+# mloop-mcp
+
+MCP (Model Context Protocol) server for [MLoop](https://github.com/iyulab/MLoop) CLI.
+
+Enables AI clients (Claude, Cursor, ironhive-cli) to perform MLOps tasks using MLoop's AutoML capabilities.
+
+## Installation
+
+```bash
+npm install -g @iyulab/mloop-mcp
+```
+
+Or run directly with npx:
+
+```bash
+npx @iyulab/mloop-mcp
+```
+
+## Prerequisites
+
+- Node.js 18+
+- MLoop CLI installed and available in PATH
+  ```bash
+  dotnet tool install -g mloop
+  ```
+
+### Custom MLoop Path
+
+If MLoop is not in PATH, set the `MLOOP_PATH` environment variable:
+
+```bash
+# Windows
+set MLOOP_PATH=D:\lib\mloop.exe
+
+# Linux/macOS
+export MLOOP_PATH=/usr/local/bin/mloop
+```
+
+## Configuration
+
+### For Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "mloop": {
+      "command": "npx",
+      "args": ["@iyulab/mloop-mcp"]
+    }
+  }
+}
+```
+
+### For ironhive-cli
+
+Add to `.ironhive/plugins.yaml`:
+
+```yaml
+plugins:
+  mloop:
+    transport: stdio
+    command: npx
+    args:
+      - "@iyulab/mloop-mcp"
+```
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `mloop_train` | Train ML models using AutoML |
+| `mloop_predict` | Run predictions with trained models |
+| `mloop_list` | List experiments and their metrics |
+| `mloop_promote` | Promote an experiment to production |
+| `mloop_info` | Analyze and profile datasets |
+| `mloop_status` | Show project status |
+| `mloop_compare` | Compare multiple experiments |
+| `mloop_evaluate` | Evaluate model performance |
+| `mloop_serve` | Start REST API server |
+
+## Tool Examples
+
+### Train a model
+
+```json
+{
+  "tool": "mloop_train",
+  "arguments": {
+    "projectPath": "/path/to/project",
+    "dataFile": "datasets/train.csv",
+    "label": "target",
+    "task": "binary-classification",
+    "time": 60
+  }
+}
+```
+
+### Run predictions
+
+```json
+{
+  "tool": "mloop_predict",
+  "arguments": {
+    "projectPath": "/path/to/project",
+    "dataFile": "datasets/test.csv",
+    "output": "predictions/output.csv"
+  }
+}
+```
+
+### List experiments
+
+```json
+{
+  "tool": "mloop_list",
+  "arguments": {
+    "projectPath": "/path/to/project",
+    "showAll": true
+  }
+}
+```
+
+### Promote to production
+
+```json
+{
+  "tool": "mloop_promote",
+  "arguments": {
+    "projectPath": "/path/to/project",
+    "experimentId": "exp-003",
+    "force": true
+  }
+}
+```
+
+### Analyze dataset
+
+```json
+{
+  "tool": "mloop_info",
+  "arguments": {
+    "dataFile": "datasets/train.csv",
+    "projectPath": "/path/to/project"
+  }
+}
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run locally
+npm start
+
+# Test with MCP Inspector
+npx @modelcontextprotocol/inspector node build/index.js
+```
+
+## Architecture
+
+```
+ironhive-cli ──[MCP/STDIO]──> mloop-mcp ──[subprocess]──> mloop CLI ──> ML.NET
+```
+
+- **Pure Bridge Pattern**: 1:1 CLI mapping, no business logic, stateless
+- **STDIO Transport**: Simple process communication
+- **Subprocess Execution**: Each tool call spawns `mloop` CLI
+
+## License
+
+MIT

package/build/executor.d.ts

@@ -0,0 +1,36 @@
+/**
+ * CLI subprocess executor for mloop commands
+ */
+export interface ExecuteOptions {
+    /** Working directory for command execution */
+    cwd?: string;
+    /** Timeout in milliseconds (default: 300000 = 5 minutes) */
+    timeout?: number;
+    /** Environment variables to pass */
+    env?: Record<string, string>;
+}
+export interface ExecuteResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+/**
+ * Execute mloop CLI command
+ *
+ * @param args - Arguments to pass to mloop command
+ * @param options - Execution options
+ * @returns Promise resolving to execution result
+ * @throws CliExecutionError if command fails
+ * @throws TimeoutError if command times out
+ */
+export declare function executeMloop(args: string[], options?: ExecuteOptions): Promise<ExecuteResult>;
+/**
+ * Build CLI arguments from a parameter object
+ * Handles common patterns like --flag, --key=value
+ */
+export declare function buildArgs(command: string, params: Record<string, unknown>): string[];
+/**
+ * Build CLI arguments for positional + named parameters
+ */
+export declare function buildArgsWithPositional(command: string, positional: string[], params: Record<string, unknown>): string[];
+//# sourceMappingURL=executor.d.ts.map

package/build/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAYD;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CA4DxB;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,EAAE,CAmBV;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAAE,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,EAAE,CAkBV"}

package/build/executor.js

@@ -0,0 +1,106 @@
+/**
+ * CLI subprocess executor for mloop commands
+ */
+import { spawn } from 'child_process';
+import { CliExecutionError, TimeoutError } from './utils/errors.js';
+const DEFAULT_TIMEOUT = 300_000; // 5 minutes
+/**
+ * Get the mloop executable path.
+ * Uses MLOOP_PATH environment variable if set, otherwise defaults to 'mloop'.
+ */
+function getMloopPath() {
+    return process.env['MLOOP_PATH'] || 'mloop';
+}
+/**
+ * Execute mloop CLI command
+ *
+ * @param args - Arguments to pass to mloop command
+ * @param options - Execution options
+ * @returns Promise resolving to execution result
+ * @throws CliExecutionError if command fails
+ * @throws TimeoutError if command times out
+ */
+export async function executeMloop(args, options = {}) {
+    const { cwd, timeout = DEFAULT_TIMEOUT, env } = options;
+    const mloopPath = getMloopPath();
+    return new Promise((resolve, reject) => {
+        const proc = spawn(mloopPath, args, {
+            cwd,
+            env: { ...process.env, ...env },
+            shell: true, // Required for Windows
+            windowsHide: true,
+        });
+        let stdout = '';
+        let stderr = '';
+        let killed = false;
+        const timeoutId = setTimeout(() => {
+            killed = true;
+            proc.kill('SIGTERM');
+            reject(new TimeoutError(`Command timed out after ${timeout}ms`, timeout));
+        }, timeout);
+        proc.stdout?.on('data', (data) => {
+            stdout += data.toString();
+        });
+        proc.stderr?.on('data', (data) => {
+            stderr += data.toString();
+        });
+        proc.on('error', (error) => {
+            clearTimeout(timeoutId);
+            reject(new CliExecutionError(`Failed to execute mloop: ${error.message}`, -1, stdout, stderr));
+        });
+        proc.on('close', (code) => {
+            clearTimeout(timeoutId);
+            if (killed)
+                return; // Already handled by timeout
+            const exitCode = code ?? 0;
+            const result = { stdout, stderr, exitCode };
+            if (exitCode !== 0) {
+                reject(new CliExecutionError(`mloop exited with code ${exitCode}`, exitCode, stdout, stderr));
+            }
+            else {
+                resolve(result);
+            }
+        });
+    });
+}
+/**
+ * Build CLI arguments from a parameter object
+ * Handles common patterns like --flag, --key=value
+ */
+export function buildArgs(command, params) {
+    const args = [command];
+    for (const [key, value] of Object.entries(params)) {
+        if (value === undefined || value === null || value === false) {
+            continue;
+        }
+        // Convert camelCase to kebab-case for CLI flags
+        const flag = `--${key.replace(/([A-Z])/g, '-$1').toLowerCase()}`;
+        if (value === true) {
+            args.push(flag);
+        }
+        else {
+            args.push(flag, String(value));
+        }
+    }
+    return args;
+}
+/**
+ * Build CLI arguments for positional + named parameters
+ */
+export function buildArgsWithPositional(command, positional, params) {
+    const args = [command, ...positional];
+    for (const [key, value] of Object.entries(params)) {
+        if (value === undefined || value === null || value === false) {
+            continue;
+        }
+        const flag = `--${key.replace(/([A-Z])/g, '-$1').toLowerCase()}`;
+        if (value === true) {
+            args.push(flag);
+        }
+        else {
+            args.push(flag, String(value));
+        }
+    }
+    return args;
+}
+//# sourceMappingURL=executor.js.map

package/build/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"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"}

package/build/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * mloop-mcp - MCP server for MLoop CLI
+ *
+ * Exposes MLoop ML.NET MLOps capabilities via Model Context Protocol
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;GAIG"}

package/build/index.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+/**
+ * mloop-mcp - MCP server for MLoop CLI
+ *
+ * Exposes MLoop ML.NET MLOps capabilities via Model Context Protocol
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from './server.js';
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Handle graceful shutdown
+    process.on('SIGINT', async () => {
+        await server.close();
+        process.exit(0);
+    });
+    process.on('SIGTERM', async () => {
+        await server.close();
+        process.exit(0);
+    });
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,2BAA2B;IAC3B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAC9B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;QAC/B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/build/server.d.ts

@@ -0,0 +1,9 @@
+/**
+ * MCP Server for MLoop CLI
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Create and configure the MCP server
+ */
+export declare function createServer(): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/build/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA+BpE;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,CA+ExC"}

package/build/server.js

@@ -0,0 +1,34 @@
+/**
+ * MCP Server for MLoop CLI
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { trainTool, train, trainSchema, predictTool, predict, predictSchema, listTool, list, listSchema, promoteTool, promote, promoteSchema, infoTool, info, infoSchema, statusTool, status, statusSchema, compareTool, compare, compareSchema, evaluateTool, evaluate, evaluateSchema, serveTool, serve, serveSchema, } from './tools/index.js';
+/**
+ * Create and configure the MCP server
+ */
+export function createServer() {
+    const server = new McpServer({
+        name: 'mloop-mcp',
+        version: '0.1.0',
+    });
+    // Register mloop_train
+    server.tool(trainTool.name, trainTool.description, trainSchema.shape, async (params) => train(params));
+    // Register mloop_predict
+    server.tool(predictTool.name, predictTool.description, predictSchema.shape, async (params) => predict(params));
+    // Register mloop_list
+    server.tool(listTool.name, listTool.description, listSchema.shape, async (params) => list(params));
+    // Register mloop_promote
+    server.tool(promoteTool.name, promoteTool.description, promoteSchema.shape, async (params) => promote(params));
+    // Register mloop_info
+    server.tool(infoTool.name, infoTool.description, infoSchema.shape, async (params) => info(params));
+    // Register mloop_status
+    server.tool(statusTool.name, statusTool.description, statusSchema.shape, async (params) => status(params));
+    // Register mloop_compare
+    server.tool(compareTool.name, compareTool.description, compareSchema.shape, async (params) => compare(params));
+    // Register mloop_evaluate
+    server.tool(evaluateTool.name, evaluateTool.description, evaluateSchema.shape, async (params) => evaluate(params));
+    // Register mloop_serve
+    server.tool(serveTool.name, serveTool.description, serveSchema.shape, async (params) => serve(params));
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/build/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EACL,SAAS,EACT,KAAK,EACL,WAAW,EACX,WAAW,EACX,OAAO,EACP,aAAa,EACb,QAAQ,EACR,IAAI,EACJ,UAAU,EACV,WAAW,EACX,OAAO,EACP,aAAa,EACb,QAAQ,EACR,IAAI,EACJ,UAAU,EACV,UAAU,EACV,MAAM,EACN,YAAY,EACZ,WAAW,EACX,OAAO,EACP,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,SAAS,EACT,KAAK,EACL,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,uBAAuB;IACvB,MAAM,CAAC,IAAI,CACT,SAAS,CAAC,IAAI,EACd,SAAS,CAAC,WAAW,EACrB,WAAW,CAAC,KAAK,EACjB,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,MAAqC,CAAC,CAC/D,CAAC;IAEF,yBAAyB;IACzB,MAAM,CAAC,IAAI,CACT,WAAW,CAAC,IAAI,EAChB,WAAW,CAAC,WAAW,EACvB,aAAa,CAAC,KAAK,EACnB,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,MAAuC,CAAC,CACnE,CAAC;IAEF,sBAAsB;IACtB,MAAM,CAAC,IAAI,CACT,QAAQ,CAAC,IAAI,EACb,QAAQ,CAAC,WAAW,EACpB,UAAU,CAAC,KAAK,EAChB,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,MAAoC,CAAC,CAC7D,CAAC;IAEF,yBAAyB;IACzB,MAAM,CAAC,IAAI,CACT,WAAW,CAAC,IAAI,EAChB,WAAW,CAAC,WAAW,EACvB,aAAa,CAAC,KAAK,EACnB,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,MAAuC,CAAC,CACnE,CAAC;IAEF,sBAAsB;IACtB,MAAM,CAAC,IAAI,CACT,QAAQ,CAAC,IAAI,EACb,QAAQ,CAAC,WAAW,EACpB,UAAU,CAAC,KAAK,EAChB,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,MAAoC,CAAC,CAC7D,CAAC;IAEF,wBAAwB;IACxB,MAAM,CAAC,IAAI,CACT,UAAU,CAAC,IAAI,EACf,UAAU,CAAC,WAAW,EACtB,YAAY,CAAC,KAAK,EAClB,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAsC,CAAC,CACjE,CAAC;IAEF,yBAAyB;IACzB,MAAM,CAAC,IAAI,CACT,WAAW,CAAC,IAAI,EAChB,WAAW,CAAC,WAAW,EACvB,aAAa,CAAC,KAAK,EACnB,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,MAAuC,CAAC,CACnE,CAAC;IAEF,0BAA0B;IAC1B,MAAM,CAAC,IAAI,CACT,YAAY,CAAC,IAAI,EACjB,YAAY,CAAC,WAAW,EACxB,cAAc,CAAC,KAAK,EACpB,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAwC,CAAC,CACrE,CAAC;IAEF,uBAAuB;IACvB,MAAM,CAAC,IAAI,CACT,SAAS,CAAC,IAAI,EACd,SAAS,CAAC,WAAW,EACrB,WAAW,CAAC,KAAK,EACjB,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,MAAqC,CAAC,CAC/D,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/build/tools/compare.d.ts

@@ -0,0 +1,53 @@
+/**
+ * mloop_compare tool - Compare experiments
+ */
+import { z } from 'zod';
+export declare const compareSchema: z.ZodObject<{
+    projectPath: z.ZodString;
+    experiments: z.ZodArray<z.ZodString, "many">;
+    modelName: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    projectPath: string;
+    experiments: string[];
+    modelName?: string | undefined;
+}, {
+    projectPath: string;
+    experiments: string[];
+    modelName?: string | undefined;
+}>;
+export type CompareParams = z.infer<typeof compareSchema>;
+export declare function compare(params: CompareParams): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare const compareTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            projectPath: {
+                type: string;
+                description: string;
+            };
+            experiments: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                minItems: number;
+                description: string;
+            };
+            modelName: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handler: typeof compare;
+};
+//# sourceMappingURL=compare.d.ts.map

package/build/tools/compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../../src/tools/compare.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,aAAa;;;;;;;;;;;;EAIxB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,wBAAsB,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CA8BnI;AAED,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;CAwBvB,CAAC"}

package/build/tools/compare.js

@@ -0,0 +1,66 @@
+/**
+ * mloop_compare tool - Compare experiments
+ */
+import { z } from 'zod';
+import { executeMloop } from '../executor.js';
+import { parseCliOutput } from '../utils/parser.js';
+import { formatError } from '../utils/errors.js';
+export const compareSchema = z.object({
+    projectPath: z.string().describe('Path to MLoop project directory'),
+    experiments: z.array(z.string()).min(2).describe('Experiment IDs to compare (at least 2)'),
+    modelName: z.string().optional().describe('Model name'),
+});
+export async function compare(params) {
+    try {
+        const { projectPath, experiments, modelName } = params;
+        const args = ['compare', ...experiments];
+        if (modelName) {
+            args.push('--name', modelName);
+        }
+        const result = await executeMloop(args, {
+            cwd: projectPath,
+        });
+        const output = parseCliOutput(result.stdout);
+        return {
+            content: [{
+                    type: 'text',
+                    text: output || 'No comparison data available.',
+                }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: formatError(error),
+                }],
+            isError: true,
+        };
+    }
+}
+export const compareTool = {
+    name: 'mloop_compare',
+    description: 'Compare metrics across multiple experiments to identify the best performing model.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            projectPath: {
+                type: 'string',
+                description: 'Path to MLoop project directory',
+            },
+            experiments: {
+                type: 'array',
+                items: { type: 'string' },
+                minItems: 2,
+                description: 'List of experiment IDs to compare (e.g., ["exp-001", "exp-002"])',
+            },
+            modelName: {
+                type: 'string',
+                description: 'Model name for namespacing',
+            },
+        },
+        required: ['projectPath', 'experiments'],
+    },
+    handler: compare,
+};
+//# sourceMappingURL=compare.js.map

package/build/tools/compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.js","sourceRoot":"","sources":["../../src/tools/compare.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IACnE,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IAC1F,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;CACxD,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAqB;IACjD,IAAI,CAAC;QACH,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAEvD,MAAM,IAAI,GAAa,CAAC,SAAS,EAAE,GAAG,WAAW,CAAC,CAAC;QACnD,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACjC,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE;YACtC,GAAG,EAAE,WAAW;SACjB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAE7C,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,MAAM,IAAI,+BAA+B;iBAChD,CAAC;SACH,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC;iBACzB,CAAC;YACF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,oFAAoF;IACjG,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iCAAiC;aAC/C;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,QAAQ,EAAE,CAAC;gBACX,WAAW,EAAE,kEAAkE;aAChF;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4BAA4B;aAC1C;SACF;QACD,QAAQ,EAAE,CAAC,aAAa,EAAE,aAAa,CAAC;KACzC;IACD,OAAO,EAAE,OAAO;CACjB,CAAC"}

package/build/tools/evaluate.d.ts

@@ -0,0 +1,56 @@
+/**
+ * mloop_evaluate tool - Evaluate model performance
+ */
+import { z } from 'zod';
+export declare const evaluateSchema: z.ZodObject<{
+    projectPath: z.ZodString;
+    dataFile: z.ZodOptional<z.ZodString>;
+    modelName: z.ZodOptional<z.ZodString>;
+    experimentId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    projectPath: string;
+    dataFile?: string | undefined;
+    modelName?: string | undefined;
+    experimentId?: string | undefined;
+}, {
+    projectPath: string;
+    dataFile?: string | undefined;
+    modelName?: string | undefined;
+    experimentId?: string | undefined;
+}>;
+export type EvaluateParams = z.infer<typeof evaluateSchema>;
+export declare function evaluate(params: EvaluateParams): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare const evaluateTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            projectPath: {
+                type: string;
+                description: string;
+            };
+            dataFile: {
+                type: string;
+                description: string;
+            };
+            modelName: {
+                type: string;
+                description: string;
+            };
+            experimentId: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handler: typeof evaluate;
+};
+//# sourceMappingURL=evaluate.d.ts.map

package/build/tools/evaluate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../src/tools/evaluate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;EAKzB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,wBAAsB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAiDrI;AAED,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BxB,CAAC"}