@apify/mcpc 0.3.0 → 0.3.1

package/docs/vhs/mcpc-demo.tape

@@ -0,0 +1,179 @@
+# mcpc demo — flagship overview
+#
+# Generate the GIF with VHS (https://github.com/charmbracelet/vhs):
+#
+#   cd docs/vhs && vhs mcpc-demo.tape
+#
+# This produces mcpc-demo.gif in the current directory. To update the demo
+# embedded in the main README, copy it to docs/images/mcpc-demo.gif.
+#
+# Prerequisites:
+#   - VHS:  brew install vhs   (or see https://github.com/charmbracelet/vhs#installation)
+#   - mcpc: npm install -g @apify/mcpc
+#   - jq:   brew install jq    (for the scripting section)
+#   - Auth: export APIFY_TOKEN=... (or remove the --header line to use anonymous access)
+#
+# This is a template — adapt the commands below for your own server,
+# tools, and audience. Use the focused tapes in this folder
+# (quickstart.tape, tools.tape, scripting.tape, grep.tape, proxy.tape)
+# as a starting point for shorter, single-feature demos.
+
+Output mcpc-demo.gif
+
+Require mcpc
+
+# Look & feel
+Set Shell           "bash"
+Set FontFamily      "JetBrains Mono"
+Set FontSize        16
+Set Width           1100
+Set Height          650
+Set Padding         20
+Set TypingSpeed     50ms
+Set PlaybackSpeed   1.0
+Set Theme           "Catppuccin Mocha"
+Set WindowBar       Colorful
+Set WindowBarSize   32
+Set BorderRadius    8
+Set CursorBlink     true
+
+# Hidden setup: clean prompt, no scrollback, fresh state
+Hide
+Type "export PS1='$ '"
+Enter
+Type "mcpc @apify close 2>/dev/null; mcpc @fs close 2>/dev/null; true"
+Enter
+Type "clear"
+Enter
+Show
+
+# 1. Discover mcpc
+Type "# mcpc — a universal MCP CLI client"
+Sleep 800ms
+Enter
+Sleep 600ms
+
+Type "mcpc --help | head -25"
+Sleep 400ms
+Enter
+Sleep 4s
+
+Type "clear"
+Enter
+Sleep 300ms
+
+# 2. List sessions and OAuth profiles
+Type "# No sessions or profiles yet"
+Sleep 600ms
+Enter
+Sleep 400ms
+
+Type "mcpc"
+Sleep 400ms
+Enter
+Sleep 3s
+
+# 3. Connect to a remote MCP server
+Type "# Connect to Apify's MCP server as session @apify"
+Sleep 600ms
+Enter
+Sleep 400ms
+
+Type 'mcpc connect mcp.apify.com @apify --header "Authorization: Bearer ${APIFY_TOKEN}"'
+Sleep 400ms
+Enter
+Sleep 3s
+
+# 4. Server info, capabilities, instructions
+Type "# Show server capabilities and instructions"
+Sleep 600ms
+Enter
+Sleep 400ms
+
+Type "mcpc @apify"
+Sleep 400ms
+Enter
+Sleep 4s
+
+Type "clear"
+Enter
+Sleep 300ms
+
+# 5. List available tools
+Type "# List available tools"
+Sleep 600ms
+Enter
+Sleep 400ms
+
+Type "mcpc @apify tools-list | head -15"
+Sleep 400ms
+Enter
+Sleep 4s
+
+# 6. Dynamic tool discovery
+Type "clear"
+Enter
+Type "# Find tools by keyword — useful for AI agents"
+Sleep 600ms
+Enter
+Sleep 400ms
+
+Type 'mcpc @apify grep "scraper"'
+Sleep 400ms
+Enter
+Sleep 4s
+
+# 7. Inspect a tool's schema
+Type "clear"
+Enter
+Type "# Inspect a tool's input schema"
+Sleep 600ms
+Enter
+Sleep 400ms
+
+Type "mcpc @apify tools-get search-actors"
+Sleep 400ms
+Enter
+Sleep 5s
+
+# 8. Call a tool
+Type "clear"
+Enter
+Type "# Call a tool with key:=value arguments"
+Sleep 600ms
+Enter
+Sleep 400ms
+
+Type 'mcpc @apify tools-call search-actors keywords:="web scraper" limit:=3'
+Sleep 400ms
+Enter
+Sleep 5s
+
+# 9. JSON mode + jq for scripting (code mode)
+Type "clear"
+Enter
+Type "# JSON mode composes with jq for scripts and agents"
+Sleep 600ms
+Enter
+Sleep 400ms
+
+Type "mcpc --json @apify tools-list | jq -r '.[].name' | head -5"
+Sleep 400ms
+Enter
+Sleep 4s
+
+# 10. Close the session
+Type "# Close the session when done"
+Sleep 600ms
+Enter
+Sleep 400ms
+
+Type "mcpc @apify close"
+Sleep 400ms
+Enter
+Sleep 2s
+
+Type "# Learn more: https://github.com/apify/mcpc"
+Sleep 2s
+Enter
+Sleep 1500ms

package/docs/vhs/proxy.tape

@@ -0,0 +1,69 @@
+# mcpc proxy — AI sandbox: expose a credentialed session without leaking tokens
+#
+#   cd docs/vhs && vhs proxy.tape
+
+Output proxy.gif
+
+Require mcpc
+
+Set Shell           "bash"
+Set FontFamily      "JetBrains Mono"
+Set FontSize        16
+Set Width           1200
+Set Height          700
+Set Padding         20
+Set TypingSpeed     50ms
+Set Theme           "Catppuccin Mocha"
+Set WindowBar       Colorful
+Set WindowBarSize   32
+Set BorderRadius    8
+
+Hide
+Type "export PS1='$ '"
+Enter
+Type "mcpc @relay close 2>/dev/null; mcpc @sandbox close 2>/dev/null; true"
+Enter
+Type "clear"
+Enter
+Show
+
+Type "# Human authenticates once and exposes a localhost MCP proxy"
+Sleep 600ms
+Enter
+Type 'mcpc connect mcp.apify.com @relay --header "Authorization: Bearer ${APIFY_TOKEN}" --proxy 8080'
+Sleep 400ms
+Enter
+Sleep 4s
+
+Type "# The proxy forwards MCP traffic but hides the upstream token"
+Sleep 600ms
+Enter
+Type "mcpc"
+Sleep 400ms
+Enter
+Sleep 4s
+
+Type "clear"
+Enter
+Type "# An AI agent (or another tool) connects to the proxy as a normal MCP server"
+Sleep 600ms
+Enter
+Type "mcpc connect localhost:8080 @sandbox"
+Sleep 400ms
+Enter
+Sleep 3s
+
+Type "mcpc @sandbox tools-list | head -8"
+Sleep 400ms
+Enter
+Sleep 5s
+
+Type "clear"
+Enter
+Type "# Tear down both sides"
+Sleep 500ms
+Enter
+Type "mcpc @sandbox close && mcpc @relay close"
+Sleep 400ms
+Enter
+Sleep 2s

package/docs/vhs/quickstart.tape

@@ -0,0 +1,59 @@
+# mcpc quickstart — first-time user flow
+#
+# A minimal demo of "install → connect → list tools → call tool".
+# Best for the README hero / landing-page GIF.
+#
+#   cd docs/vhs && vhs quickstart.tape
+
+Output quickstart.gif
+
+Require mcpc
+
+Set Shell           "bash"
+Set FontFamily      "JetBrains Mono"
+Set FontSize        16
+Set Width           1100
+Set Height          600
+Set Padding         20
+Set TypingSpeed     50ms
+Set Theme           "Catppuccin Mocha"
+Set WindowBar       Colorful
+Set WindowBarSize   32
+Set BorderRadius    8
+
+Hide
+Type "export PS1='$ '"
+Enter
+Type "mcpc @apify close 2>/dev/null; true"
+Enter
+Type "clear"
+Enter
+Show
+
+Type "# Connect to any MCP server, get a stateful session"
+Sleep 600ms
+Enter
+Type 'mcpc connect mcp.apify.com @apify --header "Authorization: Bearer ${APIFY_TOKEN}"'
+Sleep 400ms
+Enter
+Sleep 3s
+
+Type "# List the tools the server exposes"
+Sleep 500ms
+Enter
+Type "mcpc @apify tools-list | head -10"
+Sleep 400ms
+Enter
+Sleep 4s
+
+Type "# Call one of them with typed key:=value arguments"
+Sleep 500ms
+Enter
+Type 'mcpc @apify tools-call search-actors keywords:="web scraper" limit:=3'
+Sleep 400ms
+Enter
+Sleep 5s
+
+Type "mcpc @apify close"
+Enter
+Sleep 2s

package/docs/vhs/scripting.tape

@@ -0,0 +1,69 @@
+# mcpc scripting — JSON mode + jq + pipelines (code mode)
+#
+#   cd docs/vhs && vhs scripting.tape
+
+Output scripting.gif
+
+Require mcpc
+Require jq
+
+Set Shell           "bash"
+Set FontFamily      "JetBrains Mono"
+Set FontSize        16
+Set Width           1200
+Set Height          700
+Set Padding         20
+Set TypingSpeed     50ms
+Set Theme           "Catppuccin Mocha"
+Set WindowBar       Colorful
+Set WindowBarSize   32
+Set BorderRadius    8
+
+Hide
+Type "export PS1='$ '"
+Enter
+Type "mcpc connect mcp.apify.com @apify --header \"Authorization: Bearer ${APIFY_TOKEN}\" >/dev/null 2>&1 || true"
+Enter
+Type "clear"
+Enter
+Show
+
+Type "# --json emits MCP-spec JSON to stdout, errors to stderr"
+Sleep 600ms
+Enter
+Type "mcpc --json @apify tools-list | jq -r '.[].name' | head -5"
+Sleep 400ms
+Enter
+Sleep 4s
+
+Type "clear"
+Enter
+Type "# Chain tools across calls with jq + xargs"
+Sleep 500ms
+Enter
+Type "mcpc --json @apify tools-call search-actors keywords:=\"scraper\" limit:=1 \\"
+Sleep 200ms
+Enter
+Type '  | jq -r ".content[0].text | fromjson | .[0].name"'
+Sleep 400ms
+Enter
+Sleep 5s
+
+Type "clear"
+Enter
+Type "# Snapshot every tool's schema for CI / contract tests"
+Sleep 500ms
+Enter
+Type "for tool in $(mcpc --json @apify tools-list | jq -r '.[].name' | head -3); do"
+Sleep 200ms
+Enter
+Type '  mcpc --json @apify tools-get "$tool" > "/tmp/$tool.json"'
+Sleep 200ms
+Enter
+Type "  echo \"saved /tmp/$tool.json\""
+Sleep 200ms
+Enter
+Type "done"
+Sleep 400ms
+Enter
+Sleep 6s

package/docs/vhs/tools.tape

@@ -0,0 +1,66 @@
+# mcpc tools — list / get / call
+#
+#   cd docs/vhs && vhs tools.tape
+
+Output tools.gif
+
+Require mcpc
+
+Set Shell           "bash"
+Set FontFamily      "JetBrains Mono"
+Set FontSize        16
+Set Width           1100
+Set Height          650
+Set Padding         20
+Set TypingSpeed     50ms
+Set Theme           "Catppuccin Mocha"
+Set WindowBar       Colorful
+Set WindowBarSize   32
+Set BorderRadius    8
+
+Hide
+Type "export PS1='$ '"
+Enter
+Type "mcpc connect mcp.apify.com @apify --header \"Authorization: Bearer ${APIFY_TOKEN}\" >/dev/null 2>&1 || true"
+Enter
+Type "clear"
+Enter
+Show
+
+Type "# Browse the tools exposed by the server"
+Sleep 600ms
+Enter
+Type "mcpc @apify tools-list | head -15"
+Sleep 400ms
+Enter
+Sleep 4s
+
+Type "clear"
+Enter
+Type "# Inspect a single tool's input schema and description"
+Sleep 500ms
+Enter
+Type "mcpc @apify tools-get search-actors"
+Sleep 400ms
+Enter
+Sleep 5s
+
+Type "clear"
+Enter
+Type "# Call with auto-parsed key:=value arguments"
+Sleep 500ms
+Enter
+Type 'mcpc @apify tools-call search-actors keywords:="web scraper" limit:=3'
+Sleep 400ms
+Enter
+Sleep 5s
+
+Type "clear"
+Enter
+Type "# Pass complex JSON inline or from stdin"
+Sleep 500ms
+Enter
+Type 'echo '"'"'{"keywords":"crawler","limit":2}'"'"' | mcpc @apify tools-call search-actors'
+Sleep 400ms
+Enter
+Sleep 5s

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apify/mcpc",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Universal command-line client for the Model Context Protocol (MCP).",
   "type": "module",
   "keywords": [
@@ -29,37 +29,37 @@
     "node": ">=20.0.0"
   },
   "dependencies": {
-    "@inquirer/input": "^5.0.3",
-    "@inquirer/select": "^5.0.3",
-    "@modelcontextprotocol/sdk": "^1.25.1",
-    "@napi-rs/keyring": "^1.2.0",
+    "@inquirer/input": "^5.0.13",
+    "@inquirer/select": "^5.1.5",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@napi-rs/keyring": "^1.3.0",
     "chalk": "^5.6.2",
-    "commander": "^14.0.2",
-    "ora": "^9.0.0",
+    "commander": "^14.0.3",
+    "ora": "^9.4.0",
     "proper-lockfile": "^4.1.2",
     "qrcode-terminal": "^0.12.0",
-    "undici": "^7.22.0",
-    "uuid": "^13.0.0",
-    "viem": "^2.46.3"
+    "undici": "^7.25.0",
+    "uuid": "^14.0.0",
+    "viem": "^2.50.4"
   },
   "devDependencies": {
-    "@types/node": "^25.0.3",
+    "@types/node": "^25.9.1",
     "@types/proper-lockfile": "^4.1.4",
     "@types/qrcode-terminal": "^0.12.2",
     "@types/uuid": "^11.0.0",
-    "@typescript-eslint/eslint-plugin": "8.57.2",
-    "@typescript-eslint/parser": "8.57.2",
-    "@vitest/coverage-v8": "4.1.5",
+    "@typescript-eslint/eslint-plugin": "8.59.4",
+    "@typescript-eslint/parser": "8.59.4",
+    "@vitest/coverage-v8": "4.1.7",
     "c8": "^11.0.0",
-    "doctoc": "^2.2.1",
+    "doctoc": "^2.4.1",
     "eslint": "^8.57.1",
     "markdown-link-check": "^3.14.2",
     "nyc": "^18.0.0",
-    "prettier": "^3.7.4",
-    "proxy-chain": "^2.7.1",
-    "tsx": "^4.21.0",
-    "typescript": "^5.9.3",
-    "vitest": "4.1.5"
+    "prettier": "^3.8.3",
+    "proxy-chain": "^3.0.0",
+    "tsx": "^4.22.3",
+    "typescript": "^6.0.3",
+    "vitest": "4.1.7"
   },
   "devEngines": {
     "packageManager": {