clyops-mcp 0.2.0 → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dan VerWeire
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -6,7 +6,7 @@ its description and input schema come from its own `--help-json-schema`, so the
 options, types, choices and ranges the tool validates, and nothing needs to be written per tool.
 
 ```sh
-npm install -g clyops-mcp
+pnpm add --global clyops-mcp
 ```
 
 ## Local agent (stdio)
@@ -104,3 +104,8 @@ app.listen(8080);
 
 `createMcpServer({name, tools, ...})` returns the SDK `Server` for any other transport. Each HTTP
 request is handled statelessly with its own server instance.
+
+`--positionals-order first|last` controls generated argument order (default:
+`first`). An option terminator is only emitted for positional values starting
+with `-`, which are always placed after the options. The Node API exposes this
+as `positionalsOrder`.

package/dist/cli.js

@@ -20,6 +20,7 @@ cli.opt('CLYOPS_MCP_READ_ONLY', 'read-only', '', 'flag', 'Serve only tools that
 cli.optArray('CLYOPS_MCP_PATHS_WITHIN', 'paths-within', '', 'Path arguments must resolve inside this directory', 'Security', 'dir:exists');
 cli.opt('CLYOPS_MCP_MAX_OUTPUT', 'max-output', '', '16777216', 'Keep at most this many bytes of a tool\'s stdout and stderr (0: all)', 'Security', 'int:0-');
 cli.opt('CLYOPS_MCP_AUDIT', 'audit', '', 'optional', 'Append a JSON line per run to this file (-: stderr)', 'Security', 'path');
+cli.opt('CLYOPS_MCP_POSITIONALS_ORDER', 'positionals-order', '', 'first', 'Positionals before or after options', 'Tools', 'choice:first,last');
 const args = cli.run();
 // stdout is the MCP channel; clyops logs to stderr.
 const onError = (cmd, err) => warn('%s%s', cmd ? `skipping ${cmd.words.join(' ')}: ` : '', err.message);
@@ -43,6 +44,7 @@ const mcp = {
     instructions: tree.description || undefined,
     tools,
     cwd: args.CLYOPS_MCP_CWD ?? undefined,
+    positionalsOrder: args.CLYOPS_MCP_POSITIONALS_ORDER,
     timeoutMs: args.CLYOPS_MCP_TIMEOUT * 1000,
     within: within.length ? within : undefined,
     maxOutput: args.CLYOPS_MCP_MAX_OUTPUT,

package/dist/server.d.ts

@@ -2,6 +2,8 @@ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { type AuditEntry, type Tool } from 'clyops-tools';
 import type { IncomingMessage, ServerResponse } from 'node:http';
 export interface McpOptions {
+    /** Positionals before or after options (default: first). */
+    positionalsOrder?: 'first' | 'last';
     /** Server name shown to clients (e.g. the tools directory's name). */
     name: string;
     version?: string;

package/dist/server.js

@@ -109,7 +109,7 @@ export function createMcpServer(opts) {
         let result;
         try {
             result = await runTool(tool, declared ? input : checked.data, {
-                cwd: opts.cwd, timeoutMs: opts.timeoutMs, signal: extra.signal, within: opts.within, maxOutput: opts.maxOutput,
+                cwd: opts.cwd, timeoutMs: opts.timeoutMs, positionalsOrder: opts.positionalsOrder, signal: extra.signal, within: opts.within, maxOutput: opts.maxOutput,
                 stdin: stdinData, stdout: binaryStdout(tool) ? 'buffer' : 'text',
             });
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clyops-mcp",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Give an AI agent a directory of clyops tools over MCP (stdio or streamable HTTP), with each tool's input schema from its --help-json-schema.",
   "license": "MIT",
   "repository": {
@@ -35,20 +35,19 @@
     "dist",
     "src"
   ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json && chmod +x dist/cli.js",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "node --test test/*.test.mjs",
-    "prepublishOnly": "npm run build && npm test"
-  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.32.1",
-    "clyops": "0.2.0",
-    "clyops-tools": "0.2.0"
+    "clyops": "0.3.0",
+    "clyops-tools": "0.3.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
     "typescript": "^5.6.0",
     "express": "^5.2.1"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && chmod +x dist/cli.js",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test test/*.test.mjs"
   }
-}
+}

package/src/cli.ts

@@ -22,6 +22,7 @@ cli.opt('CLYOPS_MCP_READ_ONLY',         'read-only',    '',  'flag',      'Serve
 cli.optArray('CLYOPS_MCP_PATHS_WITHIN', 'paths-within', '',               'Path arguments must resolve inside this directory', 'Security', 'dir:exists');
 cli.opt('CLYOPS_MCP_MAX_OUTPUT',        'max-output',   '',  '16777216',  'Keep at most this many bytes of a tool\'s stdout and stderr (0: all)', 'Security', 'int:0-');
 cli.opt('CLYOPS_MCP_AUDIT',             'audit',        '',  'optional',  'Append a JSON line per run to this file (-: stderr)', 'Security', 'path');
+cli.opt('CLYOPS_MCP_POSITIONALS_ORDER', 'positionals-order', '', 'first', 'Positionals before or after options', 'Tools', 'choice:first,last');
 const args = cli.run();
 
 // stdout is the MCP channel; clyops logs to stderr.
@@ -46,6 +47,7 @@ const mcp = {
   instructions: tree.description || undefined,
   tools,
   cwd: (args.CLYOPS_MCP_CWD as string | null) ?? undefined,
+  positionalsOrder: args.CLYOPS_MCP_POSITIONALS_ORDER as 'first' | 'last',
   timeoutMs: (args.CLYOPS_MCP_TIMEOUT as number) * 1000,
   within: within.length ? within : undefined,
   maxOutput: args.CLYOPS_MCP_MAX_OUTPUT as number,

package/src/server.ts

@@ -9,6 +9,8 @@ import { InputError, isTextType, runTool, tail, toJsonSchema, type AuditEntry, t
 import type { IncomingMessage, ServerResponse } from 'node:http';
 
 export interface McpOptions {
+  /** Positionals before or after options (default: first). */
+  positionalsOrder?: 'first' | 'last';
   /** Server name shown to clients (e.g. the tools directory's name). */
   name: string;
   version?: string;
@@ -127,7 +129,7 @@ export function createMcpServer(opts: McpOptions): Server {
     let result: ToolResult;
     try {
       result = await runTool(tool, declared ? input : checked.data, {
-        cwd: opts.cwd, timeoutMs: opts.timeoutMs, signal: extra.signal, within: opts.within, maxOutput: opts.maxOutput,
+        cwd: opts.cwd, timeoutMs: opts.timeoutMs, positionalsOrder: opts.positionalsOrder, signal: extra.signal, within: opts.within, maxOutput: opts.maxOutput,
         stdin: stdinData, stdout: binaryStdout(tool) ? 'buffer' : 'text',
       });
     } catch (err) {