@apify/mcpc 0.1.2 → 0.1.4

package/TESTING.md

@@ -1,212 +0,0 @@
-# Quick Testing Guide for mcpc
-
-This guide provides quick commands to test the current implementation of mcpc.
-
-## Prerequisites
-
-```bash
-npm install
-npm run build
-```
-
-## Quick Tests
-
-### 1. Help and Version
-
-```bash
-# Show help
-node dist/cli/index.js --help
-
-# Show version
-node dist/cli/index.js --version
-```
-
-### 2. HTTP URL Targets
-
-```bash
-# Try to connect to a URL (will fail - no real server)
-node dist/cli/index.js https://example.com/mcp tools-list
-
-# With verbose logging
-node dist/cli/index.js https://example.com/mcp --verbose tools-list
-```
-
-### 3. Config File Loading
-
-```bash
-# List servers in config
-cat examples/test-config.json
-
-# Use HTTP server from config (will fail to connect)
-node dist/cli/index.js --config examples/test-config.json example-http tools-list
-
-# Try non-existent server (shows error)
-node dist/cli/index.js --config examples/test-config.json bad-server tools-list
-
-# Test environment variable substitution
-EXAMPLE_API_TOKEN=secret123 node dist/cli/index.js \
-  --config examples/test-config.json example-http tools-list
-```
-
-### 4. Package Resolution
-
-```bash
-# Create test package in node_modules
-mkdir -p node_modules/example-mcp-server
-cp -r examples/test-package/* node_modules/example-mcp-server/
-
-# Try to use the package (will fail - not a real MCP server)
-node dist/cli/index.js example-mcp-server tools-list
-
-# Try non-existent package (shows helpful error)
-node dist/cli/index.js nonexistent-package tools-list
-
-# With verbose to see resolution details
-node dist/cli/index.js example-mcp-server --verbose tools-list
-```
-
-### 5. Named Sessions (Not Implemented)
-
-```bash
-# Try named session (shows "not implemented")
-node dist/cli/index.js @my-session tools-list
-```
-
-## Real MCP Server Testing
-
-To test with an actual MCP server, you can:
-
-### Option 1: Install an official MCP server package
-
-```bash
-# Install a real MCP server (example - adjust as needed)
-npm install -g @modelcontextprotocol/server-filesystem
-
-# Use it with mcpc
-mcpc @modelcontextprotocol/server-filesystem tools-list
-```
-
-### Option 2: Use a remote MCP server
-
-```bash
-# If you have access to a real MCP server URL
-mcpc https://your-mcp-server.com tools-list
-mcpc https://your-mcp-server.com resources-list
-```
-
-### Option 3: Create a config file for your servers
-
-```json
-{
-  "mcpServers": {
-    "my-server": {
-      "url": "https://my-real-mcp-server.com",
-      "headers": {
-        "Authorization": "Bearer ${MY_API_KEY}"
-      }
-    },
-    "filesystem": {
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
-    }
-  }
-}
-```
-
-Then use it:
-```bash
-MY_API_KEY=secret mcpc --config my-config.json my-server tools-list
-mcpc --config my-config.json filesystem resources-list
-```
-
-## Unit Tests
-
-```bash
-# Run all tests
-npm test
-
-# Run specific test file
-npm test -- test/lib/config.test.ts
-npm test -- test/lib/logger.test.ts
-
-# Run with coverage
-npm run test:coverage
-
-# Watch mode
-npm run test:watch
-```
-
-## Linting
-
-```bash
-# Check for issues
-npm run lint
-
-# Auto-fix issues
-npm run lint:fix
-```
-
-## Expected Behaviors
-
-### ✅ Should Work
-
-- CLI help and version display
-- HTTP URL parsing and resolution
-- Config file loading and parsing
-- Environment variable substitution in configs
-- Package discovery in node_modules
-- Global package discovery (npm and Bun)
-- Clear error messages for missing files/packages
-- Verbose logging with --verbose flag
-
-### ❌ Will Fail (Expected)
-
-These will fail because they require actual MCP servers:
-
-- Connecting to example.com (not an MCP server)
-- Using the test package (doesn't implement MCP protocol)
-- Any command that needs actual MCP communication
-
-These will fail because they're not implemented yet:
-
-- Named sessions (@session-name)
-- Session commands (connect, close)
-- Interactive shell
-
-## Troubleshooting
-
-### "Package not found" error
-- Make sure the package is installed in node_modules or globally
-- Check the package name spelling
-- Verify package.json exists in the package
-
-### "Config file not found" error
-- Check the path to the config file
-- Use absolute path or path relative to current directory
-
-### "Server not found in config" error
-- Check the server name matches exactly (case-sensitive)
-- List available servers in the error message
-
-### "Failed to connect" error
-- This is expected when testing with non-real MCP servers
-- Use a real MCP server URL or package to test actual connections
-
-## What's Next
-
-After confirming tests work, you can proceed with:
-
-**Phase 2: Bridge & Sessions**
-- Persistent MCP connections
-- Session management
-- Unix socket IPC
-
-**Phase 3: Authentication**
-- OAuth 2.1 support
-- Keychain integration
-- Auth profile management
-
-**Phase 4: Enhancements**
-- Interactive shell
-- Caching
-- Tab completion

package/dist/lib/auth/auth-profiles.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"auth-profiles.d.ts","sourceRoot":"","sources":["../../../src/lib/auth/auth-profiles.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AA6EpE,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAGrE;AAKD,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAiB/D;AAKD,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAGlC;AAKD,wBAAsB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBzE;AAKD,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA0BhG"}

package/dist/lib/auth/auth-profiles.js

@@ -1,105 +0,0 @@
-import { readFile, writeFile, rename, unlink } from 'fs/promises';
-import { tmpdir } from 'os';
-import { join } from 'path';
-import { getAuthProfilesFilePath, fileExists, ensureDir, getMcpcHome } from '../utils.js';
-import { withFileLock } from '../file-lock.js';
-import { createLogger } from '../logger.js';
-import { ClientError } from '../errors.js';
-import { removeKeychainOAuthClientInfo, removeKeychainOAuthTokenInfo, } from './keychain.js';
-const logger = createLogger('auth-profiles');
-const AUTH_PROFILES_DEFAULT_CONTENT = JSON.stringify({ profiles: {} }, null, 2);
-async function loadAuthProfilesInternal() {
-    const filePath = getAuthProfilesFilePath();
-    if (!(await fileExists(filePath))) {
-        logger.debug('Auth profiles file does not exist, returning empty profiles');
-        return { profiles: {} };
-    }
-    try {
-        const content = await readFile(filePath, 'utf-8');
-        const storage = JSON.parse(content);
-        if (!storage.profiles || typeof storage.profiles !== 'object') {
-            logger.warn('Invalid auth profiles file format, returning empty profiles');
-            return { profiles: {} };
-        }
-        return storage;
-    }
-    catch (error) {
-        logger.warn(`Failed to load auth profiles: ${error.message}`);
-        return { profiles: {} };
-    }
-}
-async function saveAuthProfilesInternal(storage) {
-    const filePath = getAuthProfilesFilePath();
-    await ensureDir(getMcpcHome());
-    const tempFile = join(tmpdir(), `mcpc-auth-profiles-${Date.now()}-${process.pid}.json`);
-    try {
-        const content = JSON.stringify(storage, null, 2);
-        await writeFile(tempFile, content, { encoding: 'utf-8', mode: 0o600 });
-        await rename(tempFile, filePath);
-        logger.debug('Auth profiles saved successfully');
-    }
-    catch (error) {
-        try {
-            await unlink(tempFile);
-        }
-        catch {
-        }
-        throw new ClientError(`Failed to save auth profiles: ${error.message}`);
-    }
-}
-export async function loadAuthProfiles() {
-    const filePath = getAuthProfilesFilePath();
-    return withFileLock(filePath, loadAuthProfilesInternal, AUTH_PROFILES_DEFAULT_CONTENT);
-}
-export async function listAuthProfiles() {
-    const storage = await loadAuthProfiles();
-    const profiles = [];
-    for (const serverUrl in storage.profiles) {
-        const serverProfiles = storage.profiles[serverUrl];
-        if (serverProfiles) {
-            for (const profileName in serverProfiles) {
-                const profile = serverProfiles[profileName];
-                if (profile) {
-                    profiles.push(profile);
-                }
-            }
-        }
-    }
-    return profiles;
-}
-export async function getAuthProfile(serverUrl, profileName) {
-    const storage = await loadAuthProfiles();
-    return storage.profiles[serverUrl]?.[profileName];
-}
-export async function saveAuthProfile(profile) {
-    const filePath = getAuthProfilesFilePath();
-    return withFileLock(filePath, async () => {
-        const storage = await loadAuthProfilesInternal();
-        if (!storage.profiles[profile.serverUrl]) {
-            storage.profiles[profile.serverUrl] = {};
-        }
-        storage.profiles[profile.serverUrl][profile.name] = profile;
-        await saveAuthProfilesInternal(storage);
-        logger.debug(`Saved auth profile: ${profile.name} for ${profile.serverUrl}`);
-    }, AUTH_PROFILES_DEFAULT_CONTENT);
-}
-export async function deleteAuthProfile(serverUrl, profileName) {
-    const filePath = getAuthProfilesFilePath();
-    return withFileLock(filePath, async () => {
-        const storage = await loadAuthProfilesInternal();
-        const serverProfiles = storage.profiles[serverUrl];
-        if (!serverProfiles || !serverProfiles[profileName]) {
-            return false;
-        }
-        await removeKeychainOAuthClientInfo(serverUrl, profileName);
-        await removeKeychainOAuthTokenInfo(serverUrl, profileName);
-        delete serverProfiles[profileName];
-        if (Object.keys(serverProfiles).length === 0) {
-            delete storage.profiles[serverUrl];
-        }
-        await saveAuthProfilesInternal(storage);
-        logger.debug(`Deleted auth profile: ${profileName} for ${serverUrl}`);
-        return true;
-    }, AUTH_PROFILES_DEFAULT_CONTENT);
-}
-//# sourceMappingURL=auth-profiles.js.map

package/dist/lib/auth/auth-profiles.js.map

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