@mcp-z/cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Kevin Malakoff
+
+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

@@ -0,0 +1,166 @@
+# @mcp-z/cli
+
+Docs: https://mcp-z.github.io/cli
+MCP server lifecycle management and inspection from the command line.
+
+## Common uses
+
+- Spawn servers from `.mcp.json`
+- Inspect tools, resources, prompts, and health
+- Call tools, prompts, and resources directly
+- Search capabilities across servers
+- Generate or validate `server.json`
+
+## Install
+
+```bash
+npm install -g @mcp-z/cli
+```
+
+## Quick start
+
+### Stdio servers
+
+```json
+{
+  "mcpServers": {
+    "my-server": {
+      "command": "node",
+      "args": ["path/to/server.js"]
+    }
+  }
+}
+```
+
+```bash
+mcp-z up
+```
+
+### HTTP servers
+
+```json
+{
+  "mcpServers": {
+    "my-server": {
+      "type": "http",
+      "url": "http://localhost:3000/mcp"
+    }
+  }
+}
+```
+
+```bash
+mcp-z up
+```
+
+### HTTP + start block (extension)
+
+```json
+{
+  "mcpServers": {
+    "my-server": {
+      "type": "http",
+      "url": "http://localhost:3000/mcp",
+      "start": {
+        "command": "node",
+        "args": ["path/to/http-server.js"]
+      }
+    }
+  }
+}
+```
+
+`start` is an extension used by `npx @mcp-z/cli up` to launch HTTP servers for you.
+
+## Commands
+
+### `mcp-z up`
+
+Start MCP servers from `.mcp.json`.
+
+Common use cases:
+- Start stdio servers for local development
+- Start HTTP servers with `start` blocks
+
+### `mcp-z inspect`
+
+Inspect tools, resources, prompts, and health.
+
+Common use cases:
+- See what a server exposes before writing code
+- Debug startup issues
+
+### `mcp-z call-tool`
+
+Call a tool with JSON arguments.
+
+Common use cases:
+- Test a tool without writing code
+- Script quick one-offs
+
+### `mcp-z get-prompt`
+
+Get a prompt with optional JSON arguments.
+
+Common use cases:
+- Preview prompt outputs
+- Validate prompt arguments
+
+### `mcp-z read-resource`
+
+Read a resource by URI.
+
+Common use cases:
+- Fetch file-backed resources
+- Verify resource handlers
+
+### `mcp-z search`
+
+Search tools, prompts, and resources across servers.
+
+Common use cases:
+- Discover capabilities by keyword
+- Find the right tool in multi-server setups
+
+### `mcp-z manifest`
+
+Generate or validate `server.json`.
+
+Common use cases:
+- Author or validate MCP server manifests
+
+## Inline usage
+
+```bash
+# Stdio
+mcp-z inspect --run "npx -y @modelcontextprotocol/server-everything"
+
+# HTTP
+mcp-z inspect --url "https://api.example.com/mcp"
+```
+
+## Configuration
+
+MCP server config supports stdio and HTTP.
+
+**Stdio**
+```json
+{
+  "command": "node",
+  "args": ["server.js"],
+  "env": { "LOG_LEVEL": "info" }
+}
+```
+
+**HTTP**
+```json
+{
+  "type": "http",
+  "url": "http://localhost:3000/mcp",
+  "headers": { "Authorization": "Bearer token" }
+}
+```
+
+## Requirements
+
+- Node.js >= 24

package/bin/cli.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+// biome-ignore lint/security/noGlobalEval: dual esm and cjs
+if (typeof require === 'undefined') eval("import('../dist/esm/cli.js').then((cli) => cli.default(process.argv.slice(2), 'mcp-z')).catch((err) => { console.log(err); process.exit(-1); });");
+else require('../dist/cjs/cli.js')(process.argv.slice(2), 'mcp-z');

package/dist/cjs/cli.d.cts

@@ -0,0 +1 @@
+export default function cli(argv: string[], programName: string): void;

package/dist/cjs/cli.d.ts

@@ -0,0 +1 @@
+export default function cli(argv: string[], programName: string): void;