@modeltoolsprotocol/mtpcli 0.2.1 → 0.2.2

package/dist/index.js

@@ -9208,7 +9208,7 @@ function cleanJson(obj) {
 }
 
 // src/index.ts
-var VERSION3 = "0.2.1";
+var VERSION3 = "0.2.2";
 function selfDescribe() {
   const schema = {
     name: "mtpcli",
@@ -9355,23 +9355,23 @@ function selfDescribe() {
       },
       {
         name: "serve",
-        description: "Serve CLI tools as an MCP server over stdio",
+        description: "Serve CLI tools as an MCP server over stdio. Not meant to be run directly; add to your MCP client config instead.",
         args: [
           {
             name: "--tool",
             type: "array",
             required: true,
-            description: "Tool name(s) to serve"
+            description: "Tool name(s) to serve (must support --describe)"
           }
         ],
         examples: [
           {
-            description: "Serve a single tool",
-            command: "mtpcli serve --tool filetool"
+            description: "Add to ~/.claude.json as an MCP server",
+            command: '{ "mcpServers": { "my-tools": { "type": "stdio", "command": "mtpcli", "args": ["serve", "--tool", "my-cli-tool"] } } }'
           },
           {
-            description: "Serve multiple tools",
-            command: "mtpcli serve --tool filetool --tool mytool"
+            description: "Serve multiple tools in one MCP server",
+            command: '{ "mcpServers": { "my-tools": { "type": "stdio", "command": "mtpcli", "args": ["serve", "--tool", "tool1", "--tool", "tool2"] } } }'
           }
         ]
       },
@@ -9541,7 +9541,42 @@ authCmd.command("refresh").description("Force-refresh the stored OAuth token for
   const { runRefresh: runRefresh2 } = await Promise.resolve().then(() => (init_auth(), exports_auth));
   await runRefresh2(tool);
 });
-program2.command("serve").description("Serve CLI tools as an MCP server (cli2mcp bridge)").requiredOption("--tool <names...>", "Tool(s) to serve").action(async (opts) => {
+program2.command("serve").description("Serve CLI tools as an MCP server (cli2mcp bridge)").requiredOption("--tool <names...>", "Tool(s) to serve").addHelpText("after", `
+This command is meant to be used as an MCP server, not run directly.
+Add it to your MCP client config (e.g. ~/.claude.json):
+
+  {
+    "mcpServers": {
+      "my-tools": {
+        "type": "stdio",
+        "command": "mtpcli",
+        "args": ["serve", "--tool", "my-cli-tool"]
+      }
+    }
+  }
+
+Any CLI tool on your PATH that supports --describe can be served.
+Multiple tools can be combined into a single MCP server:
+
+  mtpcli serve --tool tool1 --tool tool2`).action(async (opts) => {
+  if (process.stdin.isTTY) {
+    process.stderr.write(`Error: 'mtpcli serve' is an MCP server and should not be run directly.
+` + `Add it to your MCP client config instead. For example, in ~/.claude.json:
+
+` + `  {
+` + `    "mcpServers": {
+` + `      "my-tools": {
+` + `        "type": "stdio",
+` + `        "command": "mtpcli",
+` + `        "args": ["serve", "--tool", ${JSON.stringify(opts.tool[0] ?? "my-cli-tool")}]
+` + `      }
+` + `    }
+` + `  }
+
+` + `Run 'mtpcli serve --help' for more details.
+`);
+    process.exit(1);
+  }
   const { run: run5 } = await Promise.resolve().then(() => (init_serve(), exports_serve));
   await run5(opts.tool);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modeltoolsprotocol/mtpcli",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "license": "Apache-2.0",
   "type": "module",
   "bin": {