Added E2E tests with Bun runtime (#25)

Author: jancurn

.github/workflows/ci.yml

@@ -54,6 +54,9 @@ jobs:
       - name: Build
         run: npm run build
 
+      - name: Install Bun
+        uses: oven-sh/setup-bun@v2
+
       - name: E2E tests
         # Run without gnome-keyring: @napi-rs/keyring fails fast when no D-Bus secret
         # service is available, and keychain.ts automatically falls back to encrypted

CHANGELOG.md

@@ -7,6 +7,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+- E2E tests now run under the Bun runtime (in addition to Node.js); use `./test/e2e/run.sh --runtime bun` or `npm run test:e2e:bun`
+
 ### Changed
 - OS keychain now falls back to `~/.mcpc/credentials.json` (mode 0600) when no keyring daemon is available (e.g. headless Linux servers, containers)
 

README.md

@@ -47,6 +47,9 @@ After all, UNIX-compatible shell script is THE most universal coding language.
 
 ```bash
 npm install -g @apify/mcpc
+
+# Or with Bun
+bun install -g @apify/mcpc
 ```
 
 **Linux users:** `mcpc` uses the OS keychain for secure credential storage via the

package.json

@@ -32,14 +32,15 @@
     "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 4",
+    "test": "npm run build && npm run test:unit && ./test/e2e/run.sh --no-build --parallel 4 && ./test/e2e/run.sh --no-build --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\"",

test/e2e/lib/framework.sh

@@ -179,7 +179,8 @@ _cleanup_keychain() {
 # ============================================================================
 
 # Path to mcpc
-MCPC="node $PROJECT_ROOT/dist/cli/index.js"
+# Runtime can be overridden via E2E_RUNTIME env var (e.g. E2E_RUNTIME=bun)
+MCPC="${E2E_RUNTIME:-node} $PROJECT_ROOT/dist/cli/index.js"
 
 # Run mcpc and capture output
 # Sets: STDOUT, STDERR, EXIT_CODE

test/e2e/run.sh

@@ -29,6 +29,7 @@ KEEP_RUNS=false
 VERBOSE=false
 LIST_ONLY=false
 SKIP_BUILD=false
+RUNTIME="node"
 PATTERNS=()
 
 # Colors
@@ -66,6 +67,10 @@ while [[ $# -gt 0 ]]; do
       LIST_ONLY=true
       shift
       ;;
+    -r|--runtime)
+      RUNTIME="$2"
+      shift 2
+      ;;
     -b|--no-build)
       SKIP_BUILD=true
       shift
@@ -75,6 +80,7 @@ while [[ $# -gt 0 ]]; do
       echo ""
       echo "Options:"
       echo "  -p, --parallel N   Max parallel tests (default: 16)"
+      echo "  -r, --runtime <r>  Runtime for mcpc: node (default) or bun"
       echo "  -i, --isolated     Force all tests to use isolated home directories"
       echo "  -c, --coverage     Collect code coverage"
       echo "  -b, --no-build     Skip building mcpc (assumes dist/ is up to date)"
@@ -163,6 +169,25 @@ if [[ ${#TESTS[@]} -eq 0 ]]; then
   exit 1
 fi
 
+# Validate runtime and resolve version string
+case "$RUNTIME" in
+  node)
+    RUNTIME_VERSION="node $(node --version)"
+    ;;
+  bun)
+    if ! command -v bun &>/dev/null; then
+      echo "bun is not installed; skipping bun runtime tests"
+      exit 0
+    fi
+    RUNTIME_VERSION="bun $(bun --version)"
+    ;;
+  *)
+    echo "Unknown runtime: $RUNTIME (valid options: node, bun)" >&2
+    exit 1
+    ;;
+esac
+export E2E_RUNTIME="$RUNTIME"
+
 # List mode
 if [[ "$LIST_ONLY" == "true" ]]; then
   echo "Available tests:"
@@ -190,6 +215,7 @@ echo "Run ID:    $E2E_RUN_ID"
 echo "Run dir:   $RUN_DIR"
 echo "Tests:     ${#TESTS[@]}"
 echo "Parallel:  $PARALLEL"
+echo "Runtime:   $RUNTIME_VERSION"
 if [[ "$ISOLATED_ALL" == "true" ]]; then
   echo "Home dirs: isolated (per-test)"
 else
@@ -252,7 +278,7 @@ run_test() {
 }
 
 export -f run_test test_name
-export SCRIPT_DIR SUITES_DIR E2E_RUN_ID E2E_RUNS_DIR E2E_SHARED_HOME E2E_ISOLATED_ALL PROJECT_ROOT NODE_V8_COVERAGE
+export SCRIPT_DIR SUITES_DIR E2E_RUN_ID E2E_RUNS_DIR E2E_SHARED_HOME E2E_ISOLATED_ALL E2E_RUNTIME PROJECT_ROOT NODE_V8_COVERAGE
 
 # Run tests
 echo -e "${BLUE}Running tests...${NC}"

test/e2e/suites/basic/bun.test.sh

@@ -0,0 +1,112 @@
+#!/bin/bash
+# Test: mcpc works under the Bun runtime
+# Skipped automatically if bun is not installed.
+#
+# When run standalone this sets MCPC to use bun directly.
+# When run via `./run.sh --runtime bun`, E2E_RUNTIME=bun is already set by the
+# runner and framework.sh picks it up; the explicit override below is a no-op.
+
+source "$(dirname "$0")/../../lib/framework.sh"
+test_init "basic/bun"
+
+# Skip entire test suite if bun is not available
+if ! command -v bun &>/dev/null; then
+  echo "# Bun not installed, skipping"
+  test_case "bun runtime (skipped - bun not installed)"
+  test_skip "bun not installed"
+  test_done
+fi
+
+BUN_VERSION=$(bun --version)
+echo "# Bun version: $BUN_VERSION"
+
+# Ensure all mcpc invocations in this file use bun (for standalone runs)
+MCPC="bun $PROJECT_ROOT/dist/cli/index.js"
+
+# Start test server (still uses Node/tsx - it's the remote MCP server, not the client)
+start_test_server
+
+# Test: --version works under Bun
+test_case "bun: --version works"
+run_mcpc --version
+assert_success
+if [[ ! "$STDOUT" =~ ^[0-9]+\.[0-9]+\.[0-9]+ ]]; then
+  test_fail "version should be semver format, got: $STDOUT"
+  exit 1
+fi
+test_pass
+
+# Test: --help works under Bun
+test_case "bun: --help works"
+run_mcpc --help
+assert_success
+assert_contains "$STDOUT" "Usage:"
+assert_contains "$STDOUT" "mcpc"
+test_pass
+
+# Test: --json output works under Bun
+test_case "bun: --version --json works"
+run_mcpc --version --json
+assert_success
+assert_json_valid "$STDOUT"
+assert_json "$STDOUT" '.version'
+test_pass
+
+# Test: tools-list via direct connection
+test_case "bun: tools-list (direct connection)"
+run_xmcpc "$TEST_SERVER_URL" tools-list
+assert_success
+assert_contains "$STDOUT" "echo"
+test_pass
+
+# Test: tools-call via direct connection
+test_case "bun: tools-call (direct connection)"
+run_mcpc "$TEST_SERVER_URL" tools-call echo 'message:=hello from bun'
+assert_success
+assert_contains "$STDOUT" "hello from bun"
+test_pass
+
+# Test: resources-list via direct connection
+test_case "bun: resources-list (direct connection)"
+run_xmcpc "$TEST_SERVER_URL" resources-list
+assert_success
+test_pass
+
+# Test: JSON mode via direct connection
+test_case "bun: tools-list --json (direct connection)"
+run_mcpc --json "$TEST_SERVER_URL" tools-list
+assert_success
+assert_json_valid "$STDOUT"
+test_pass
+
+# =============================================================================
+# Keychain path: create a session with a bearer token.
+# mcpc stores the token in the OS keychain (via @napi-rs/keyring) on connect,
+# then reads it back on every subsequent command.  This exercises the native
+# keyring add-on under the Bun runtime.
+# =============================================================================
+
+test_case "bun: session with bearer token (keychain write)"
+SESSION=$(session_name "bearer")
+run_mcpc "$TEST_SERVER_URL" --header "Authorization: Bearer testtoken-bun-$$" connect "$SESSION"
+assert_success
+test_pass
+
+test_case "bun: session tools-list (keychain read)"
+run_xmcpc "$SESSION" tools-list
+assert_success
+assert_contains "$STDOUT" "echo"
+test_pass
+
+test_case "bun: session tools-call (keychain read)"
+run_mcpc "$SESSION" tools-call echo 'message:=hello from bun session'
+assert_success
+assert_contains "$STDOUT" "hello from bun session"
+test_pass
+
+test_case "bun: session close"
+run_mcpc "$SESSION" close
+assert_success
+test_pass
+
+test_done