mcp-caller 0.0.4 → 0.0.5

package/README.md

@@ -48,6 +48,12 @@ Read JSON from files instead of inline values:
 npx -y mcp-caller --server-file server.json --call-file call.json
 ```
 
+Short call form:
+
+```bash
+npx -y mcp-caller --server-file server.json --tool say_hello --params-json '{"name":"world"}'
+```
+
 List callable tools:
 
 ```bash

package/index.js

@@ -9,6 +9,7 @@ function printUsage() {
   console.error(`Usage:
   mcp-caller --server-json <json> --list-tools
   mcp-caller --server-json <json> --inspect
+  mcp-caller --server-json <json> --tool <name> [--params-json <json>]
   mcp-caller --server-json <json> --call-json <json>
   mcp-caller --server-file <path> --call-file <path>
 
@@ -59,6 +60,16 @@ function readSource(options, jsonKey, fileKey, label) {
   throw new Error(`Missing ${label}`);
 }
 
+function readParams(options) {
+  if (options.paramsFile) {
+    return parseJson(readFileSync(options.paramsFile, "utf8"), "--params-json/--params-file");
+  }
+  if (options.paramsJson) {
+    return parseJson(options.paramsJson, "--params-json/--params-file");
+  }
+  return {};
+}
+
 function parseArgs(argv) {
   const options = {};
   for (let i = 0; i < argv.length; i += 1) {
@@ -83,6 +94,18 @@ function parseArgs(argv) {
       options.callFile = argv[++i];
       continue;
     }
+    if (token === "--tool") {
+      options.tool = argv[++i];
+      continue;
+    }
+    if (token === "--params-json") {
+      options.paramsJson = argv[++i];
+      continue;
+    }
+    if (token === "--params-file") {
+      options.paramsFile = argv[++i];
+      continue;
+    }
     if (token === "--list-tools") {
       options.listTools = true;
       continue;
@@ -196,9 +219,22 @@ async function main() {
   }
 
   const serverSource = readSource(options, "serverJson", "serverFile", "--server-json/--server-file");
+  if (options.tool && (options.callJson || options.callFile)) {
+    throw new Error("Use either --tool/--params-json or --call-json/--call-file, not both");
+  }
+  if (options.tool && options.tool.trim().length === 0) {
+    throw new Error('Option "--tool" must be a non-empty string');
+  }
+
+  const shorthandCall = options.tool
+    ? {
+        tool: options.tool,
+        params: readParams(options)
+      }
+    : null;
   const callSource = options.listTools || options.inspect
     ? null
-    : readSource(options, "callJson", "callFile", "--call-json/--call-file");
+    : shorthandCall ?? readSource(options, "callJson", "callFile", "--call-json/--call-file");
 
   if (callSource) {
     if (typeof callSource !== "object") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-caller",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "A small MCP client CLI that can start a server and call a tool from JSON input.",
   "type": "module",
   "main": "index.js",