@modeltoolsprotocol/mtpcli 1.3.1 → 1.3.3

package/dist/index.js

@@ -8843,7 +8843,7 @@ var init_mcp = __esm(() => {
 });
 
 // src/version.ts
-var VERSION2 = "1.3.1";
+var VERSION2 = "1.3.3";
 
 // src/serve.ts
 var exports_serve = {};
@@ -9940,7 +9940,7 @@ function parseHeaders(raw) {
   }
   return headers;
 }
-async function run2(serverCmd, serverUrl, toolName, toolArgs = [], rawHeaders = [], clientId) {
+async function run2(serverCmd, serverUrl, toolName, toolArgs = [], rawHeaders = [], clientId, describe2) {
   let client;
   let serverName;
   if (serverUrl) {
@@ -9965,7 +9965,7 @@ async function run2(serverCmd, serverUrl, toolName, toolArgs = [], rawHeaders =
       description: `CLI wrapper for MCP server: ${serverName}`,
       commands
     };
-    if (!toolName) {
+    if (describe2 || !toolName) {
       console.log(JSON.stringify(schema, null, 2));
       return;
     }
@@ -10642,6 +10642,15 @@ function describe(program2, options) {
 function withDescribe(program2, options) {
   program2.option("--mtp-describe", "Output machine-readable MTP JSON schema");
   program2.on("option:mtp-describe", () => {
+    const subNames = new Set;
+    for (const cmd of program2.commands) {
+      subNames.add(cmd.name());
+      for (const alias of cmd.aliases())
+        subNames.add(alias);
+    }
+    const args = process.argv.slice(2);
+    if (args.some((a) => subNames.has(a)))
+      return;
     const schema = describe(program2, options);
     const clean = JSON.parse(JSON.stringify(schema));
     console.log(JSON.stringify(clean, null, 2));
@@ -10651,10 +10660,67 @@ function withDescribe(program2, options) {
 }
 
 // src/version.ts
-var VERSION = "1.3.1";
+var VERSION = "1.3.3";
 
 // src/index.ts
-var program2 = new Command().name("mtpcli").version(VERSION).description("Unified CLI for discovering, authenticating, and bridging --mtp-describe-compatible tools");
+var program2 = new Command().name("mtpcli").version(VERSION).description("Unified CLI for discovering, authenticating, and bridging --mtp-describe-compatible tools").addHelpText("after", `
+MTP: Using CLI Tools as an LLM Agent
+
+Discovery
+  Any tool supporting MTP responds to --mtp-describe with a JSON schema:
+
+    toolname --mtp-describe
+
+  This returns: tool name, commands, args (name, type, required, default),
+  stdin/stdout descriptors, and examples.
+
+Invoking Commands
+  Schema maps directly to CLI invocation:
+
+    "name": "convert"       -> toolname convert
+    "name": "auth login"    -> toolname auth login
+    "name": "_root"         -> toolname (no subcommand)
+    Args with -- prefix are flags: --format json
+    Args without prefix are positional: toolname convert myfile.csv
+    "type": "boolean" flags take no value: --verbose
+    "type": "array" flags repeat: --tag foo --tag bar
+
+Stdin/Stdout
+  When a command has stdin declared, pipe data in:
+
+    echo '{"name":"foo"}' | toolname process
+    cat file.csv | toolname convert --format json
+
+  When stdout has contentType "application/json", output is parseable:
+
+    toolname convert data.csv --format json | jq '.results'
+
+mtpcli Usage
+
+  Understand mtpcli by running: mtpcli --mtp-describe
+
+  Search for commands across tools:
+
+    mtpcli search "deploy to production"
+    mtpcli search "convert csv" -- filetool mytool
+    mtpcli search --scan-path "git commit"
+
+  Wrap an MCP server as a CLI:
+
+    mtpcli wrap --url "https://mcp.example.com/v1/mcp" --mtp-describe
+    mtpcli wrap --url "https://mcp.example.com/v1/mcp" toolName -- --arg1 val1
+    mtpcli wrap --server "npx @mcp/server" toolName -- --arg1 val1
+
+  Auth:
+
+    mtpcli auth login toolname              # OAuth2 flow
+    mtpcli auth login toolname --token sk-x # API key
+    eval $(mtpcli auth env toolname)        # Inject token into env
+
+Composability
+  Chain tools with pipes. No LLM round-trip needed for intermediate steps:
+
+    toolA export --format json | toolB import --stdin | jq '.summary'`);
 program2.command("search").description("Search across --mtp-describe-compatible tools").argument("<query>", "Search query").option("--json", "Output as JSON", false).option("--scan-path", "Scan PATH for --mtp-describe-compatible tools", false).option("--jobs <n>", "Number of parallel jobs for --scan-path", "16").argument("[tools...]", "Tool names to search (after --)").action(async (query, tools, opts) => {
   const { search: search2, loadSchemas: loadSchemas2, scanPath: scanPath2 } = await Promise.resolve().then(() => (init_search(), exports_search));
   const schemas = opts.scanPath ? await scanPath2(parseInt(opts.jobs, 10)) : await loadSchemas2(tools);
@@ -10802,7 +10868,7 @@ Multiple tools can be combined into a single MCP server:
   const { run: run5 } = await Promise.resolve().then(() => (init_serve(), exports_serve));
   await run5(opts.tool);
 });
-program2.command("wrap").description("Wrap an MCP server as a CLI tool (mcp2cli bridge)").option("--server <cmd>", "MCP server command to run (stdio transport)").option("--url <url>", "MCP server URL (Streamable HTTP / SSE transport)").option("-H, --header <header...>", "HTTP header(s) for --url (e.g. 'Authorization: Bearer tok')").option("--client-id <id>", "Pre-registered OAuth client ID (for --url)").argument("[tool_name]", "Tool name to invoke").argument("[args...]", "Arguments for the tool (after --)").action(async (toolName, args, opts) => {
+program2.command("wrap").description("Wrap an MCP server as a CLI tool (mcp2cli bridge)").option("--server <cmd>", "MCP server command to run (stdio transport)").option("--url <url>", "MCP server URL (Streamable HTTP / SSE transport)").option("-H, --header <header...>", "HTTP header(s) for --url (e.g. 'Authorization: Bearer tok')").option("--client-id <id>", "Pre-registered OAuth client ID (for --url)").option("--mtp-describe", "Output MTP schema for the wrapped MCP server").argument("[tool_name]", "Tool name to invoke").argument("[args...]", "Arguments for the tool (after --)").action(async (toolName, args, opts) => {
   if (opts.server && opts.url) {
     process.stderr.write(`error: --server and --url are mutually exclusive
 `);
@@ -10824,7 +10890,7 @@ program2.command("wrap").description("Wrap an MCP server as a CLI tool (mcp2cli
     process.exit(1);
   }
   const { run: run5 } = await Promise.resolve().then(() => (init_wrap(), exports_wrap));
-  await run5(opts.server, opts.url, toolName, args, opts.header ?? [], opts.clientId);
+  await run5(opts.server, opts.url, toolName, args, opts.header ?? [], opts.clientId, opts.mtpDescribe);
 });
 program2.command("validate").description("Validate a tool's --mtp-describe output against the MTP spec").argument("[tool]", "Tool name to validate").option("--json", "Output as JSON", false).option("--stdin", "Read JSON from stdin", false).option("--skip-help", "Skip --help cross-reference", false).action(async (tool, opts) => {
   const { run: run5 } = await Promise.resolve().then(() => (init_validate(), exports_validate));
@@ -10892,9 +10958,9 @@ var describeOptions = {
     },
     wrap: {
       examples: [
-        { description: "Describe a stdio MCP server", command: 'mtpcli wrap --server "npx @mcp/server-github"' },
+        { description: "Describe a stdio MCP server", command: 'mtpcli wrap --server "npx @mcp/server-github" --mtp-describe' },
         { description: "Call a tool on a stdio server", command: 'mtpcli wrap --server "npx @mcp/server-github" search_repos -- --query mtpcli' },
-        { description: "Describe an HTTP MCP server", command: "mtpcli wrap --url http://localhost:3000/mcp" },
+        { description: "Describe an HTTP MCP server", command: "mtpcli wrap --url http://localhost:3000/mcp --mtp-describe" },
         { description: "Call a tool on an HTTP server", command: "mtpcli wrap --url http://localhost:3000/mcp search_repos -- --query mtpcli" }
       ]
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modeltoolsprotocol/mtpcli",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "license": "Apache-2.0",
   "type": "module",
   "bin": {
@@ -17,7 +17,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@modeltoolsprotocol/sdk": "^0.4.0",
+    "@modeltoolsprotocol/sdk": "^0.4.1",
     "commander": "^14.0.0",
     "jaro-winkler": "^0.2.8",
     "open": "^11.0.0",