@iris-eval/mcp-server 0.2.3 → 0.2.4

package/dist/config/index.js

@@ -38,13 +38,20 @@ function loadConfigFile(path) {
         throw new Error(`Invalid JSON in config file ${path}: ${err.message}`);
     }
 }
+function parsePortEnv(value, name) {
+    const n = parseInt(value, 10);
+    if (!Number.isFinite(n) || n < 1 || n > 65535) {
+        throw new Error(`${name}=${JSON.stringify(value)} is not a valid port (must be an integer 1-65535)`);
+    }
+    return n;
+}
 function loadEnvVars() {
     const config = {};
     if (process.env.IRIS_TRANSPORT) {
         config.transport = { type: process.env.IRIS_TRANSPORT };
     }
     if (process.env.IRIS_PORT) {
-        config.transport = { ...config.transport, port: parseInt(process.env.IRIS_PORT) };
+        config.transport = { ...config.transport, port: parsePortEnv(process.env.IRIS_PORT, 'IRIS_PORT') };
     }
     if (process.env.IRIS_HOST) {
         config.transport = { ...config.transport, host: process.env.IRIS_HOST };
@@ -61,7 +68,7 @@ function loadEnvVars() {
     if (process.env.IRIS_DASHBOARD_PORT) {
         config.dashboard = {
             ...config.dashboard,
-            port: parseInt(process.env.IRIS_DASHBOARD_PORT),
+            port: parsePortEnv(process.env.IRIS_DASHBOARD_PORT, 'IRIS_DASHBOARD_PORT'),
         };
     }
     if (process.env.IRIS_API_KEY) {

package/dist/index.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { parseArgs } from 'node:util';
+import { z } from 'zod';
 import { loadConfig } from './config/index.js';
 import { createStorage } from './storage/index.js';
 import { createIrisServer } from './server.js';
@@ -7,19 +8,52 @@ import { createStdioTransport } from './transport/stdio.js';
 import { createHttpTransport } from './transport/http.js';
 import { createDashboardServer } from './dashboard/server.js';
 import { createLogger } from './utils/logger.js';
-const { values } = parseArgs({
-    options: {
-        transport: { type: 'string', default: undefined },
-        port: { type: 'string', default: undefined },
-        config: { type: 'string', default: undefined },
-        'db-path': { type: 'string', default: undefined },
-        'api-key': { type: 'string', default: undefined },
-        dashboard: { type: 'boolean', default: false },
-        'dashboard-port': { type: 'string', default: undefined },
-        help: { type: 'boolean', short: 'h', default: false },
-    },
-    strict: false,
-});
+const PortSchema = z
+    .string()
+    .regex(/^\d+$/, 'must be a positive integer')
+    .transform((s) => parseInt(s, 10))
+    .refine((n) => Number.isFinite(n) && n >= 1 && n <= 65535, 'must be between 1 and 65535');
+const CliSchema = z
+    .object({
+    transport: z.enum(['stdio', 'http']).optional(),
+    port: PortSchema.optional(),
+    config: z.string().min(1).optional(),
+    'db-path': z.string().min(1).optional(),
+    'api-key': z.string().min(1).optional(),
+    dashboard: z.boolean().optional(),
+    'dashboard-port': PortSchema.optional(),
+    help: z.boolean().optional(),
+})
+    .strict();
+let parsed;
+try {
+    parsed = parseArgs({
+        options: {
+            transport: { type: 'string' },
+            port: { type: 'string' },
+            config: { type: 'string' },
+            'db-path': { type: 'string' },
+            'api-key': { type: 'string' },
+            dashboard: { type: 'boolean', default: false },
+            'dashboard-port': { type: 'string' },
+            help: { type: 'boolean', short: 'h', default: false },
+        },
+        strict: true,
+    });
+}
+catch (err) {
+    process.stderr.write(`iris-mcp: ${err.message}\nRun \`iris-mcp --help\` for usage.\n`);
+    process.exit(2);
+}
+const validation = CliSchema.safeParse(parsed.values);
+if (!validation.success) {
+    const issues = validation.error.issues
+        .map((i) => `  --${i.path.join('.')}: ${i.message}`)
+        .join('\n');
+    process.stderr.write(`iris-mcp: invalid argument(s):\n${issues}\nRun \`iris-mcp --help\` for usage.\n`);
+    process.exit(2);
+}
+const values = validation.data;
 if (values.help) {
     process.stderr.write(`
 Iris — MCP-Native Agent Eval Server
@@ -28,24 +62,36 @@ Usage: iris-mcp [options]
 
 Options:
   --transport <type>       Transport type: stdio (default) or http
-  --port <number>          HTTP transport port (default: 3000)
+  --port <number>          HTTP transport port 1-65535 (default: 3000)
   --config <path>          Config file path (default: ~/.iris/config.json)
   --db-path <path>         SQLite database path (default: ~/.iris/iris.db)
   --api-key <key>          API key for HTTP authentication
   --dashboard              Enable web dashboard
-  --dashboard-port <port>  Dashboard port (default: 6920)
+  --dashboard-port <port>  Dashboard port 1-65535 (default: 6920)
   -h, --help               Show this help message
+
+Environment variables (CLI flags take precedence):
+  IRIS_TRANSPORT           stdio | http
+  IRIS_HOST                Bind address for HTTP transport (default: 127.0.0.1)
+  IRIS_PORT                HTTP transport port (1-65535)
+  IRIS_DB_PATH             SQLite database path
+  IRIS_LOG_LEVEL           debug | info | warn | error
+  IRIS_DASHBOARD           true to enable web dashboard
+  IRIS_DASHBOARD_PORT      Dashboard port (1-65535, default: 6920)
+  IRIS_API_KEY             API key for HTTP authentication
+  IRIS_ALLOWED_ORIGINS     Comma-separated CORS origin allowlist
+  RATE_LIMIT_SALT          (waitlist API only — required when website is deployed)
 `);
     process.exit(0);
 }
 const config = loadConfig({
     transport: values.transport,
-    port: values.port ? parseInt(values.port) : undefined,
+    port: values.port,
     config: values.config,
     dbPath: values['db-path'],
     apiKey: values['api-key'],
     dashboard: values.dashboard,
-    dashboardPort: values['dashboard-port'] ? parseInt(values['dashboard-port']) : undefined,
+    dashboardPort: values['dashboard-port'],
 });
 const logger = createLogger(config);
 async function main() {

package/dist/storage/index.js

@@ -4,7 +4,7 @@ export function createStorage(config) {
         case 'sqlite':
             return new SqliteAdapter(config.storage.path);
         default:
-            throw new Error(`Unsupported storage type: ${config.storage.type}`);
+            throw new Error(`Unsupported storage type: ${config.storage.type} (supported: sqlite)`);
     }
 }
 export { SqliteAdapter } from './sqlite-adapter.js';

package/dist/storage/sqlite-adapter.js

@@ -73,10 +73,10 @@ export class SqliteAdapter {
         const sortBy = options.sort_by ?? 'timestamp';
         const sortOrder = options.sort_order ?? 'desc';
         if (!ALLOWED_SORT_COLUMNS.has(sortBy)) {
-            throw new Error(`Invalid sort column: ${sortBy}`);
+            throw new Error(`Invalid sort column: ${sortBy} (allowed: ${[...ALLOWED_SORT_COLUMNS].join(', ')})`);
         }
         if (!ALLOWED_SORT_ORDERS.has(sortOrder)) {
-            throw new Error(`Invalid sort order: ${sortOrder}`);
+            throw new Error(`Invalid sort order: ${sortOrder} (allowed: ${[...ALLOWED_SORT_ORDERS].join(', ')})`);
         }
         const limit = options.limit ?? 50;
         const offset = options.offset ?? 0;
@@ -371,7 +371,7 @@ export class SqliteAdapter {
         };
         const query = queries[column];
         if (!query) {
-            throw new Error(`Column '${column}' is not queryable`);
+            throw new Error(`Column '${column}' is not queryable (allowed: ${Object.keys(queries).join(', ')})`);
         }
         const rows = this.db.prepare(query).all();
         return rows.map((row) => row[column]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iris-eval/mcp-server",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "The agent eval standard for MCP. Score every agent output for quality, safety, and cost.",
   "mcpName": "io.github.iris-eval/mcp-server",
   "type": "module",

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/iris-eval/mcp-server",
     "source": "github"
   },
-  "version": "0.2.3",
+  "version": "0.2.4",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@iris-eval/mcp-server",
-      "version": "0.2.3",
+      "version": "0.2.4",
       "transport": {
         "type": "stdio"
       },