mcp-caller 0.0.2 → 0.0.4

package/README.md

@@ -30,16 +30,16 @@ Call a remote streamable HTTP MCP server:
 
 ```bash
 npx -y mcp-caller \
-  --server-json '{"mcpServers":{"context7":{"type":"streamable-http","url":"https://mcp.context7.com/mcp","headers":{"CONTEXT7_API_KEY":"YOUR_API_KEY"}}}}' \
-  --call-json '{"tool":"resolve-library-id","params":{"query":"Express","libraryName":"Express"}}'
+  --server-json '{"type":"streamable-http","url":"https://gitmcp.io/idosal/git-mcp"}' \
+  --call-json '{"tool":"fetch_git_mcp_documentation","params":{}}'
 ```
 
 PowerShell:
 
 ```powershell
 npx -y mcp-caller `
-  --server-json '{"mcpServers":{"context7":{"type":"streamable-http","url":"https://mcp.context7.com/mcp","headers":{"CONTEXT7_API_KEY":"YOUR_API_KEY"}}}}' `
-  --call-json '{"tool":"resolve-library-id","params":{"query":"Express","libraryName":"Express"}}'
+  --server-json '{"type":"streamable-http","url":"https://gitmcp.io/idosal/git-mcp"}' `
+  --call-json '{"tool":"fetch_git_mcp_documentation","params":{}}'
 ```
 
 Read JSON from files instead of inline values:
@@ -48,6 +48,18 @@ Read JSON from files instead of inline values:
 npx -y mcp-caller --server-file server.json --call-file call.json
 ```
 
+List callable tools:
+
+```bash
+npx -y mcp-caller --server-file server.json --list-tools
+```
+
+Inspect tools, prompts, and resources:
+
+```bash
+npx -y mcp-caller --server-file server.json --inspect --pretty
+```
+
 ## JSON Shapes
 
 Server JSON:
@@ -87,4 +99,4 @@ Call JSON:
 
 - The CLI prints text content when the tool result contains text.
 - Use `--pretty` to format non-text JSON output.
-- The Context7 integration example is covered by [test/cli.examples.test.js](d:/projects/culled/mcp-caller/test/cli.examples.test.js).
+- The example probes are covered by [test/cli.examples.test.js](d:/projects/culled/mcp-caller/test/cli.examples.test.js).

package/index.js

@@ -7,6 +7,8 @@ import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/
 
 function printUsage() {
   console.error(`Usage:
+  mcp-caller --server-json <json> --list-tools
+  mcp-caller --server-json <json> --inspect
   mcp-caller --server-json <json> --call-json <json>
   mcp-caller --server-file <path> --call-file <path>
 
@@ -81,6 +83,14 @@ function parseArgs(argv) {
       options.callFile = argv[++i];
       continue;
     }
+    if (token === "--list-tools") {
+      options.listTools = true;
+      continue;
+    }
+    if (token === "--inspect") {
+      options.inspect = true;
+      continue;
+    }
     if (token === "--server-name") {
       options.serverName = argv[++i];
       continue;
@@ -153,6 +163,31 @@ function extractText(result) {
   return pieces.join("\n");
 }
 
+function printTools(tools) {
+  for (const tool of tools) {
+    console.log(`- ${tool.name}${tool.description ? `: ${tool.description}` : ""}`);
+  }
+}
+
+function formatInspect(serverName, tools, prompts, resources) {
+  return {
+    server: serverName,
+    tools: tools.map((tool) => ({
+      name: tool.name,
+      description: tool.description ?? ""
+    })),
+    prompts: prompts.map((prompt) => ({
+      name: prompt.name,
+      description: prompt.description ?? ""
+    })),
+    resources: resources.map((resource) => ({
+      uri: resource.uri,
+      name: resource.name ?? "",
+      description: resource.description ?? ""
+    }))
+  };
+}
+
 async function main() {
   const options = parseArgs(process.argv.slice(2));
   if (options.help) {
@@ -161,13 +196,17 @@ async function main() {
   }
 
   const serverSource = readSource(options, "serverJson", "serverFile", "--server-json/--server-file");
-  const callSource = readSource(options, "callJson", "callFile", "--call-json/--call-file");
+  const callSource = options.listTools || options.inspect
+    ? null
+    : readSource(options, "callJson", "callFile", "--call-json/--call-file");
 
-  if (!callSource || typeof callSource !== "object") {
-    throw new Error("Call JSON must be an object");
-  }
-  if (typeof callSource.tool !== "string" || !callSource.tool) {
-    throw new Error('Call JSON must include a non-empty "tool" string');
+  if (callSource) {
+    if (typeof callSource !== "object") {
+      throw new Error("Call JSON must be an object");
+    }
+    if (typeof callSource.tool !== "string" || !callSource.tool) {
+      throw new Error('Call JSON must include a non-empty "tool" string');
+    }
   }
 
   const { server } = resolveServerDefinition(serverSource, options.serverName);
@@ -177,18 +216,49 @@ async function main() {
   try {
     await client.connect(transport);
 
-    const result = await client.callTool({
-      name: callSource.tool,
-      arguments: callSource.params ?? callSource.arguments ?? {}
-    });
+    if (options.listTools || options.inspect) {
+      const [toolsResult, promptsResult, resourcesResult] = await Promise.all([
+        client.listTools(),
+        options.inspect ? client.listPrompts() : Promise.resolve({ prompts: [] }),
+        options.inspect ? client.listResources() : Promise.resolve({ resources: [] })
+      ]);
 
-    const text = extractText(result);
-    if (text) {
-      console.log(text);
+      if (options.listTools) {
+        printTools(toolsResult.tools ?? []);
+        return;
+      }
+
+      console.log(JSON.stringify(
+        formatInspect(
+          options.serverName ?? (serverSource?.mcpServers ? Object.keys(serverSource.mcpServers)[0] : "server"),
+          toolsResult.tools ?? [],
+          promptsResult.prompts ?? [],
+          resourcesResult.resources ?? []
+        ),
+        null,
+        options.pretty ? 2 : 0
+      ));
       return;
     }
 
-    console.log(JSON.stringify(result, null, options.pretty ? 2 : 0));
+    if (!options.listTools && !options.inspect && !callSource) {
+      throw new Error("Missing --call-json/--call-file, or use --list-tools / --inspect");
+    }
+
+    if (callSource) {
+      const result = await client.callTool({
+        name: callSource.tool,
+        arguments: callSource.params ?? callSource.arguments ?? {}
+      });
+
+      const text = extractText(result);
+      if (text) {
+        console.log(text);
+        return;
+      }
+
+      console.log(JSON.stringify(result, null, options.pretty ? 2 : 0));
+    }
   } finally {
     await client.close().catch(() => {});
   }

package/package.json

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