@apify/mcpc 0.2.6 → 0.3.0-beta.1

package/dist/lib/wallets.js.map

@@ -1 +1 @@
-{"version":3,"file":"wallets.js","sourceRoot":"","sources":["../../src/lib/wallets.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"wallets.js","sourceRoot":"","sources":["../../src/lib/wallets.ts"],"names":[],"mappings":"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"}

package/docs/examples/company-lookup.sh

@@ -0,0 +1,134 @@
+#!/bin/bash
+#
+# Company Lookup Script using mcpc + Apify RAG Web Browser
+#
+# This is an example of an AI-generated "code mode" script that uses mcpc
+# to call MCP tools programmatically. It was generated by Claude Code + Opus 4.5.
+#
+# Prerequisites:
+#   1. Install mcpc: npm install -g @apify/mcpc
+#   2. Login to Apify MCP server: mcpc mcp.apify.com login
+#   3. Create a session: mcpc mcp.apify.com connect @apify
+#
+# Usage:
+#   ./company-lookup.sh "Company Name"
+#
+# Example:
+#   ./company-lookup.sh "Stripe"
+#   ./company-lookup.sh "Anthropic"
+#
+
+set -e
+
+# Configuration
+SESSION="${MCPC_SESSION:-@apify}"
+REQUIRED_TOOL="apify-slash-rag-web-browser"
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[0;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Helper functions
+error() { echo -e "${RED}❌ Error: $1${NC}" >&2; exit 1; }
+info() { echo -e "${BLUE}$1${NC}"; }
+success() { echo -e "${GREEN}$1${NC}"; }
+warn() { echo -e "${YELLOW}$1${NC}"; }
+
+# Check if mcpc is installed
+if ! command -v mcpc &> /dev/null; then
+    error "mcpc is not installed. Install it with: npm install -g @apify/mcpc"
+fi
+
+# Parse arguments
+COMPANY="${1:-}"
+if [ -z "$COMPANY" ]; then
+    echo "Usage: $0 \"Company Name\""
+    echo ""
+    echo "Examples:"
+    echo "  $0 \"Stripe\""
+    echo "  $0 \"Anthropic\""
+    echo ""
+    echo "Environment variables:"
+    echo "  MCPC_SESSION  Session to use (default: @apify)"
+    exit 1
+fi
+
+# Check if the session exists and is live
+info "🔌 Checking session ${SESSION}..."
+
+SESSION_STATUS=$(mcpc --json 2>/dev/null | jq -r ".sessions[] | select(.name == \"${SESSION}\") | .status" 2>/dev/null || echo "")
+
+if [ -z "$SESSION_STATUS" ]; then
+    echo ""
+    error "Session ${SESSION} not found.
+
+To set up the required session:
+  1. Login to Apify: mcpc mcp.apify.com login
+  2. Create session: mcpc mcp.apify.com connect ${SESSION}
+
+Or use a different session by setting MCPC_SESSION environment variable."
+fi
+
+if [ "$SESSION_STATUS" = "expired" ]; then
+    error "Session ${SESSION} has expired. Please recreate it:
+  mcpc ${SESSION} close
+  mcpc mcp.apify.com connect ${SESSION}"
+fi
+
+if [ "$SESSION_STATUS" = "crashed" ]; then
+    warn "⚠️  Session ${SESSION} has crashed, will attempt to restart..."
+fi
+
+# Verify the required tool is available
+info "🔧 Checking for required tool..."
+
+TOOL_EXISTS=$(mcpc --json "${SESSION}" tools-list 2>/dev/null | jq -r ".[] | select(.name == \"${REQUIRED_TOOL}\") | .name" 2>/dev/null || echo "")
+
+if [ -z "$TOOL_EXISTS" ]; then
+    error "Required tool '${REQUIRED_TOOL}' not found on server.
+Make sure you're connected to the correct MCP server (mcp.apify.com)."
+fi
+
+# All checks passed, proceed with the lookup
+echo ""
+info "🔍 Looking up: $COMPANY"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+info "⏳ Searching the web..."
+echo ""
+
+# Build the query - company name + search terms
+QUERY="${COMPANY} company headquarters address"
+
+# Use mcpc with the RAG web browser to fetch results as JSON
+RESULT=$(mcpc "${SESSION}" tools-call "${REQUIRED_TOOL}" \
+    query:="$QUERY" \
+    maxResults:=1 \
+    outputFormats:='["markdown"]' \
+    --json 2>/dev/null) || error "Failed to call tool. Check your session and try again."
+
+# Parse the markdown from the result
+MARKDOWN=$(echo "$RESULT" \
+    | jq -r '.content[0].text // empty' 2>/dev/null \
+    | jq -r '.[0].markdown // empty' 2>/dev/null)
+
+# Check if we got results
+if [ -z "$MARKDOWN" ]; then
+    warn "⚠️  No results found for '$COMPANY'"
+    echo ""
+    echo "Raw response:"
+    echo "$RESULT" | jq '.' 2>/dev/null || echo "$RESULT"
+    exit 1
+fi
+
+echo "📄 Company Information:"
+echo "────────────────────────────────────────────────────"
+# Show first 50 lines of markdown
+echo "$MARKDOWN" | head -50
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+success "✅ Done"

package/docs/examples/mcp-config.json

@@ -0,0 +1,28 @@
+{
+  "mcpServers": {
+    "playwright": {
+      "command": "npx",
+      "args": ["@playwright/mcp@latest"]
+    },
+
+    "fs": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "${PWD}"]
+    },
+
+    "apify-public": {
+      "url": "https://mcp.apify.com/?tools=docs,search-actors"
+    },
+
+    "apify-bearer": {
+      "url": "https://mcp.apify.com",
+      "headers": {
+        "Authorization": "Bearer ${APIFY_TOKEN}"
+      }
+    },
+
+    "apify-oauth": {
+      "url": "https://mcp.apify.com"
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apify/mcpc",
-  "version": "0.2.6",
+  "version": "0.3.0-beta.1",
   "description": "Universal command-line client for the Model Context Protocol (MCP).",
   "type": "module",
   "keywords": [
@@ -28,31 +28,6 @@
   "engines": {
     "node": ">=20.0.0"
   },
-  "scripts": {
-    "build": "tsc",
-    "build:watch": "tsc --watch",
-    "build:readme": "./scripts/update-readme.sh",
-    "test": "npm run build && npm run test:unit && ./test/e2e/run.sh --no-build --parallel 8 && ./test/e2e/run.sh --no-build --parallel 8 --runtime bun",
-    "test:unit": "jest",
-    "test:watch": "jest --watch",
-    "test:coverage": "npm run test:coverage:unit && npm run test:coverage:e2e && npm run test:coverage:merge",
-    "test:coverage:unit": "jest --coverage && find test/coverage/unit -name '*.html' -exec sed -i '' -e 's/Code coverage report for All files/mcpc Coverage (Unit Tests)/g' -e 's/<h1>All files<\\/h1>/<h1>Unit Test Coverage<\\/h1>/g' {} \\;",
-    "test:coverage:e2e": "./test/e2e/run.sh --coverage",
-    "test:coverage:merge": "test/coverage/coverage-merge.sh",
-    "test:e2e": "./test/e2e/run.sh --keep",
-    "test:e2e:bun": "./test/e2e/run.sh --no-build --runtime bun",
-    "lint": "eslint src/**/*.ts && prettier --check \"src/**/*.ts\" \"test/**/*.ts\"",
-    "lint:fix": "eslint src/**/*.ts --fix && prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
-    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
-    "format:check": "prettier --check \"src/**/*.ts\" \"test/**/*.ts\"",
-    "clean": "rm -rf dist",
-    "prebuild": "npm run clean",
-    "prepublishOnly": "if [ -z \"$MCPC_RELEASE\" ]; then echo '\\n❌ Direct npm publish is not allowed.\\n   Please use: npm run release\\n' && exit 1; fi",
-    "release": "bash scripts/publish.sh",
-    "release:minor": "bash scripts/publish.sh minor",
-    "release:major": "bash scripts/publish.sh major",
-    "release:pre": "bash scripts/publish.sh --pre-release"
-  },
   "dependencies": {
     "@inquirer/input": "^5.0.3",
     "@inquirer/select": "^5.0.3",
@@ -68,23 +43,54 @@
     "viem": "^2.46.3"
   },
   "devDependencies": {
-    "@types/jest": "^30.0.0",
     "@types/node": "^25.0.3",
     "@types/proper-lockfile": "^4.1.4",
     "@types/qrcode-terminal": "^0.12.2",
     "@types/uuid": "^11.0.0",
-    "@typescript-eslint/eslint-plugin": "^8.50.0",
-    "@typescript-eslint/parser": "^8.50.0",
+    "@typescript-eslint/eslint-plugin": "8.57.2",
+    "@typescript-eslint/parser": "8.57.2",
+    "@vitest/coverage-v8": "4.1.5",
     "c8": "^11.0.0",
     "doctoc": "^2.2.1",
     "eslint": "^8.57.1",
-    "jest": "^30.2.0",
     "markdown-link-check": "^3.14.2",
     "nyc": "^18.0.0",
     "prettier": "^3.7.4",
     "proxy-chain": "^2.7.1",
-    "ts-jest": "^29.4.6",
     "tsx": "^4.21.0",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "vitest": "4.1.5"
+  },
+  "devEngines": {
+    "packageManager": {
+      "name": "pnpm",
+      "version": "10.33.4",
+      "onFail": "warn"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "build:readme": "./scripts/update-readme.sh",
+    "test": "pnpm run build && pnpm run test:unit && ./test/e2e/run.sh --no-build --parallel 8 && ./test/e2e/run.sh --no-build --parallel 8 --runtime bun",
+    "test:unit": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "pnpm run test:coverage:unit && pnpm run test:coverage:e2e && pnpm run test:coverage:merge",
+    "test:coverage:unit": "vitest run --coverage",
+    "test:coverage:e2e": "./test/e2e/run.sh --coverage",
+    "test:coverage:merge": "test/coverage/coverage-merge.sh",
+    "test:e2e": "./test/e2e/run.sh --keep",
+    "test:e2e:bun": "./test/e2e/run.sh --no-build --runtime bun",
+    "test:conformance": "pnpm run build && npx -y @modelcontextprotocol/conformance client --command \"node test/conformance/client.mjs\" --scenario initialize",
+    "lint": "eslint src/**/*.ts && prettier --check \"src/**/*.ts\" \"test/**/*.ts\"",
+    "lint:fix": "eslint src/**/*.ts --fix && prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"test/**/*.ts\"",
+    "clean": "rm -rf dist",
+    "prebuild": "pnpm run clean",
+    "release": "bash scripts/publish.sh",
+    "release:minor": "bash scripts/publish.sh minor",
+    "release:major": "bash scripts/publish.sh major",
+    "release:pre": "bash scripts/publish.sh --pre-release"
   }
-}
+}

package/pnpm-workspace.yaml

@@ -0,0 +1,10 @@
+# Supply-chain protection: require packages to be at least X days old before pnpm will install them.
+# Mitigates compromised npm packages discovered and yanked within the first day (shai-hulud worm,
+# nx self-replicator, etc.). 7200 minutes = 5 days.
+minimumReleaseAge: 7200
+
+# @napi-rs/keyring ships a native node binding that needs to be built/copied
+# into place on install. Without this entry pnpm v10 refuses to run its
+# postinstall script and the keychain feature breaks at runtime.
+onlyBuiltDependencies:
+  - "@napi-rs/keyring"

package/tsconfig.test.json

@@ -2,7 +2,8 @@
   "extends": "./tsconfig.json",
   "compilerOptions": {
     "module": "ES2022",
-    "moduleResolution": "bundler"
+    "moduleResolution": "bundler",
+    "types": ["vitest/globals", "node"]
   },
   "include": [
     "test/**/*",

package/vitest.config.ts

@@ -0,0 +1,26 @@
+import { defineConfig } from 'vitest/config';
+
+// Coverage thresholds match the previous Jest setup (70% across the board).
+// See test/README.md for the test layout.
+export default defineConfig({
+  test: {
+    include: ['test/unit/**/*.test.ts', 'test/unit/**/*.spec.ts'],
+    environment: 'node',
+    // `globals: true` keeps the existing test bodies (`describe`/`it`/`expect`)
+    // working without changing every file's imports. Jest-compatible API.
+    globals: true,
+    coverage: {
+      provider: 'v8',
+      reportsDirectory: 'test/coverage/unit',
+      reporter: ['text', 'lcov', 'html', 'json'],
+      include: ['src/**/*.ts'],
+      exclude: ['src/**/*.d.ts', 'src/**/index.ts'],
+      thresholds: {
+        branches: 70,
+        functions: 70,
+        lines: 70,
+        statements: 70,
+      },
+    },
+  },
+});