@metalabdesign/mcp-client 1.0.2 → 1.0.3

package/CHANGELOG.md

@@ -5,6 +5,11 @@ All notable changes to `@metalabdesign/mcp-client` will be documented in this fi
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.3] - 2026-01-28
+
+### Fixed
+- Added `files` field to package.json so README.md and CHANGELOG.md are included in npm package
+
 ## [1.0.2] - 2026-01-28
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metalabdesign/mcp-client",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "MCP client for connecting to Metalab's MCP Gateway with OAuth 2.1 authentication",
   "type": "module",
   "main": "dist/index.js",
@@ -19,6 +19,11 @@
   "publishConfig": {
     "access": "public"
   },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
   "keywords": [
     "mcp",
     "oauth",

package/src/bin/cli.ts

@@ -1,242 +0,0 @@
-#!/usr/bin/env node
-/**
- * MCP Local Proxy CLI
- *
- * Usage:
- *   mcp-local-proxy --remote-url <url> --callback-url <url> [options]
- *
- * Example:
- *   mcp-local-proxy \
- *     --remote-url https://mcp.example.com/mcp \
- *     --callback-url http://localhost:9876/callback
- */
-
-import { createProxy } from '../index.js';
-
-interface CliArgs {
-    remoteUrl?: string;
-    callbackUrl?: string;
-    tokenStorageDir?: string;
-    timeout?: number;
-    openBrowser?: boolean;
-    logLevel?: 'debug' | 'info' | 'warn' | 'error';
-    serviceTokens?: Record<string, string>;
-    help?: boolean;
-}
-
-function printHelp(): void {
-    console.error(`
-MCP Local Proxy - Connect to remote OAuth-protected MCP servers
-
-USAGE:
-  mcp-local-proxy --remote-url <url> --callback-url <url> [options]
-
-REQUIRED:
-  --remote-url <url>     Remote MCP server URL
-  --callback-url <url>   OAuth callback URL with port (e.g., http://localhost:9876/callback)
-
-OPTIONS:
-  --token-dir <dir>      Directory for token storage (default: ~/.metalab/mcp-local-proxy/tokens)
-  --timeout <ms>         Request timeout in milliseconds (default: 30000)
-  --no-browser           Don't auto-open browser for auth
-  --log-level <level>    Log level: debug, info, warn, error (default: info)
-  --figma-token <token>  Figma access token (alternative: FIGMA_ACCESS_TOKEN env var)
-  --notion-token <token> Notion access token (alternative: NOTION_ACCESS_TOKEN env var)
-  --help, -h             Show this help message
-
-EXAMPLES:
-  # Basic usage
-  mcp-local-proxy \\
-    --remote-url https://mcp.example.com/mcp \\
-    --callback-url http://localhost:9876/callback
-
-  # With custom callback port (specify in URL)
-  mcp-local-proxy \\
-    --remote-url https://mcp.example.com/mcp \\
-    --callback-url http://localhost:3000/oauth/callback
-
-  # Debug mode
-  mcp-local-proxy \\
-    --remote-url https://mcp.example.com/mcp \\
-    --callback-url http://localhost:9876/callback \\
-    --log-level debug
-
-  # With Figma token
-  mcp-local-proxy \\
-    --remote-url https://mcp.example.com/mcp \\
-    --callback-url http://localhost:9876/callback \\
-    --figma-token figd_xxxxx
-
-  # Multiple service tokens
-  mcp-local-proxy \\
-    --remote-url https://mcp.example.com/mcp \\
-    --callback-url http://localhost:9876/callback \\
-    --figma-token figd_xxxxx \\
-    --notion-token secret_xxxxx
-
-CLAUDE DESKTOP CONFIGURATION:
-  Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
-
-  # Basic configuration
-  {
-    "mcpServers": {
-      "my-remote-server": {
-        "command": "npx",
-        "args": [
-          "@metalab/mcp-local-proxy",
-          "--remote-url", "https://mcp.example.com/mcp",
-          "--callback-url", "http://localhost:9876/callback"
-        ]
-      }
-    }
-  }
-
-  # With service tokens (CLI args)
-  {
-    "mcpServers": {
-      "metalab-mcp": {
-        "command": "npx",
-        "args": [
-          "@metalab/mcp-local-proxy",
-          "--remote-url", "https://mcp.example.com/mcp",
-          "--callback-url", "http://localhost:9876/callback",
-          "--figma-token", "figd_xxxxx"
-        ]
-      }
-    }
-  }
-
-  # With service tokens (environment variables)
-  {
-    "mcpServers": {
-      "metalab-mcp": {
-        "command": "npx",
-        "args": [
-          "@metalab/mcp-local-proxy",
-          "--remote-url", "https://mcp.example.com/mcp",
-          "--callback-url", "http://localhost:9876/callback"
-        ],
-        "env": {
-          "FIGMA_ACCESS_TOKEN": "figd_xxxxx"
-        }
-      }
-    }
-  }
-`);
-}
-
-function parseArgs(argv: string[]): CliArgs {
-    const args: CliArgs = {
-        serviceTokens: {},
-    };
-    let i = 2; // Skip 'node' and script path
-
-    while (i < argv.length) {
-        const arg = argv[i];
-
-        switch (arg) {
-            case '--remote-url':
-                args.remoteUrl = argv[++i];
-                break;
-            case '--callback-url':
-                args.callbackUrl = argv[++i];
-                break;
-            case '--token-dir':
-                args.tokenStorageDir = argv[++i];
-                break;
-            case '--timeout':
-                args.timeout = Number.parseInt(argv[++i] ?? '', 10);
-                break;
-            case '--no-browser':
-                args.openBrowser = false;
-                break;
-            case '--log-level':
-                args.logLevel = argv[++i] as CliArgs['logLevel'];
-                break;
-            case '--figma-token':
-            case '--figma':
-                args.serviceTokens!.figma = argv[++i] ?? '';
-                break;
-            case '--notion-token':
-            case '--notion':
-                args.serviceTokens!.notion = argv[++i] ?? '';
-                break;
-            case '--help':
-            case '-h':
-                args.help = true;
-                break;
-            default:
-                if (arg?.startsWith('-')) {
-                    console.error(`Unknown option: ${arg}`);
-                    process.exit(1);
-                }
-        }
-        i++;
-    }
-
-    // Load service tokens from environment variables (fallback)
-    if (process.env.FIGMA_ACCESS_TOKEN) {
-        args.serviceTokens!.figma = args.serviceTokens!.figma || process.env.FIGMA_ACCESS_TOKEN;
-    }
-    if (process.env.NOTION_ACCESS_TOKEN) {
-        args.serviceTokens!.notion = args.serviceTokens!.notion || process.env.NOTION_ACCESS_TOKEN;
-    }
-
-    // Clean up empty serviceTokens object
-    if (Object.keys(args.serviceTokens!).length === 0) {
-        delete args.serviceTokens;
-    }
-
-    return args;
-}
-
-async function main(): Promise<void> {
-    const args = parseArgs(process.argv);
-
-    if (args.help) {
-        printHelp();
-        process.exit(0);
-    }
-
-    if (!args.remoteUrl) {
-        console.error('Error: --remote-url is required');
-        console.error('Run with --help for usage information');
-        process.exit(1);
-    }
-
-    if (!args.callbackUrl) {
-        console.error('Error: --callback-url is required');
-        console.error('Run with --help for usage information');
-        process.exit(1);
-    }
-
-    try {
-        const proxy = await createProxy({
-            remoteUrl: args.remoteUrl,
-            callbackUrl: args.callbackUrl,
-            tokenStorageDir: args.tokenStorageDir,
-            timeout: args.timeout,
-            openBrowser: args.openBrowser ?? true,
-            logLevel: args.logLevel ?? 'info',
-            serviceTokens: args.serviceTokens,
-        });
-
-        // Handle shutdown gracefully
-        const shutdown = async (): Promise<void> => {
-            console.error('Shutting down...');
-            await proxy.disconnect();
-            process.exit(0);
-        };
-
-        process.on('SIGINT', shutdown);
-        process.on('SIGTERM', shutdown);
-
-        // Start the proxy
-        await proxy.start();
-    } catch (error) {
-        console.error('Failed to start proxy:', error);
-        process.exit(1);
-    }
-}
-
-main();

package/src/bin/metalab-mcp-config.ts

@@ -1,262 +0,0 @@
-#!/usr/bin/env node
-/**
- * Metalab MCP Config Generator
- *
- * Generates JSON configuration for various MCP clients like Claude Desktop,
- * Windsurf, Cursor, and VS Code.
- */
-
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import * as os from 'node:os';
-import * as readline from 'node:readline';
-
-interface ClientConfig {
-    name: string;
-    configPath: string;
-    description: string;
-}
-
-const CLIENTS: Record<string, ClientConfig> = {
-    claude: {
-        name: 'Claude Desktop',
-        configPath:
-            process.platform === 'darwin'
-                ? path.join(os.homedir(), 'Library/Application Support/Claude/claude_desktop_config.json')
-                : process.platform === 'win32'
-                  ? path.join(process.env.APPDATA || '', 'Claude/claude_desktop_config.json')
-                  : path.join(os.homedir(), '.config/Claude/claude_desktop_config.json'),
-        description: 'Anthropic Claude Desktop application',
-    },
-    windsurf: {
-        name: 'Windsurf',
-        configPath: path.join(os.homedir(), '.codeium/windsurf/mcp_config.json'),
-        description: 'Codeium Windsurf IDE',
-    },
-    cursor: {
-        name: 'Cursor',
-        configPath: path.join(os.homedir(), '.cursor/mcp.json'),
-        description: 'Cursor IDE',
-    },
-    cline: {
-        name: 'VS Code (Cline)',
-        configPath: path.join(process.cwd(), '.vscode/cline_mcp_settings.json'),
-        description: 'VS Code with Cline extension (project-local)',
-    },
-    vscode: {
-        name: 'VS Code (Cline)',
-        configPath: path.join(process.cwd(), '.vscode/cline_mcp_settings.json'),
-        description: 'Alias for cline',
-    },
-};
-
-interface CliArgs {
-    client?: string;
-    figmaToken?: string;
-    notionToken?: string;
-    output?: boolean;
-    help?: boolean;
-}
-
-function printHelp(): void {
-    console.error(`
-Metalab MCP Config Generator
-
-USAGE:
-  metalab-mcp-config [options]
-
-OPTIONS:
-  --client <name>        Generate config for specific client
-                         Options: claude, windsurf, cursor, cline, vscode
-  --figma-token <token>  Include Figma token in config
-  --notion-token <token> Include Notion token in config
-  --output               Write config directly to client's config file
-  --help, -h             Show this help message
-
-EXAMPLES:
-  # Interactive mode (prompts for client)
-  metalab-mcp-config
-
-  # Generate Claude Desktop config
-  metalab-mcp-config --client claude
-
-  # Generate config with tokens
-  metalab-mcp-config --client claude --figma-token figd_xxxxx
-
-  # Write directly to config file
-  metalab-mcp-config --client claude --output
-
-SUPPORTED CLIENTS:
-  claude    - Claude Desktop (macOS/Windows/Linux)
-  windsurf  - Codeium Windsurf IDE
-  cursor    - Cursor IDE
-  cline     - VS Code with Cline extension
-  vscode    - Alias for cline
-`);
-}
-
-function parseArgs(argv: string[]): CliArgs {
-    const args: CliArgs = {};
-    let i = 2;
-
-    while (i < argv.length) {
-        const arg = argv[i];
-
-        switch (arg) {
-            case '--client':
-                args.client = argv[++i];
-                break;
-            case '--figma-token':
-                args.figmaToken = argv[++i];
-                break;
-            case '--notion-token':
-                args.notionToken = argv[++i];
-                break;
-            case '--output':
-                args.output = true;
-                break;
-            case '--help':
-            case '-h':
-                args.help = true;
-                break;
-            default:
-                if (arg?.startsWith('-')) {
-                    console.error(`Unknown option: ${arg}`);
-                    process.exit(1);
-                }
-        }
-        i++;
-    }
-
-    // Load tokens from env if not provided
-    if (!args.figmaToken && process.env.FIGMA_ACCESS_TOKEN) {
-        args.figmaToken = process.env.FIGMA_ACCESS_TOKEN;
-    }
-    if (!args.notionToken && process.env.NOTION_ACCESS_TOKEN) {
-        args.notionToken = process.env.NOTION_ACCESS_TOKEN;
-    }
-
-    return args;
-}
-
-function generateConfig(args: CliArgs): object {
-    const env: Record<string, string> = {};
-
-    if (args.figmaToken) {
-        env.FIGMA_ACCESS_TOKEN = args.figmaToken;
-    }
-    if (args.notionToken) {
-        env.NOTION_ACCESS_TOKEN = args.notionToken;
-    }
-
-    const serverConfig: Record<string, unknown> = {
-        command: 'npx',
-        args: ['@metalabdesign/mcp-client'],
-    };
-
-    if (Object.keys(env).length > 0) {
-        serverConfig.env = env;
-    }
-
-    return {
-        mcpServers: {
-            metalab: serverConfig,
-        },
-    };
-}
-
-async function promptForClient(): Promise<string> {
-    const rl = readline.createInterface({
-        input: process.stdin,
-        output: process.stderr,
-    });
-
-    console.error('\nSelect an MCP client:\n');
-    const clientList: Array<keyof typeof CLIENTS> = ['claude', 'windsurf', 'cursor', 'cline'];
-    clientList.forEach((key, i) => {
-        const client = CLIENTS[key]!;
-        console.error(`  ${i + 1}. ${client.name} - ${client.description}`);
-    });
-    console.error('');
-
-    return new Promise((resolve) => {
-        rl.question('Enter number (1-4): ', (answer) => {
-            rl.close();
-            const index = parseInt(answer, 10) - 1;
-            if (index >= 0 && index < clientList.length) {
-                resolve(clientList[index] as string);
-            } else {
-                console.error('Invalid selection, using claude');
-                resolve('claude');
-            }
-        });
-    });
-}
-
-function mergeConfig(existingPath: string, newConfig: object): object {
-    try {
-        if (fs.existsSync(existingPath)) {
-            const existing = JSON.parse(fs.readFileSync(existingPath, 'utf-8'));
-            // Merge mcpServers
-            return {
-                ...existing,
-                mcpServers: {
-                    ...(existing.mcpServers || {}),
-                    ...(newConfig as { mcpServers: object }).mcpServers,
-                },
-            };
-        }
-    } catch {
-        // If we can't read existing, just use new config
-    }
-    return newConfig;
-}
-
-async function main(): Promise<void> {
-    const args = parseArgs(process.argv);
-
-    if (args.help) {
-        printHelp();
-        process.exit(0);
-    }
-
-    let clientKey = args.client;
-
-    // Interactive mode if no client specified
-    if (!clientKey) {
-        clientKey = await promptForClient();
-    }
-
-    // Validate client and get config
-    const client = CLIENTS[clientKey];
-    if (!client) {
-        console.error(`Unknown client: ${clientKey}`);
-        console.error(`Valid options: ${Object.keys(CLIENTS).join(', ')}`);
-        process.exit(1);
-    }
-
-    const config = generateConfig(args);
-
-    if (args.output) {
-        // Write to file
-        const configDir = path.dirname(client.configPath);
-        if (!fs.existsSync(configDir)) {
-            fs.mkdirSync(configDir, { recursive: true });
-        }
-
-        const mergedConfig = mergeConfig(client.configPath, config);
-        fs.writeFileSync(client.configPath, JSON.stringify(mergedConfig, null, 2) + '\n');
-
-        console.error(`\n✓ Configuration written to: ${client.configPath}`);
-        console.error(`\nRestart ${client.name} to apply changes.`);
-    } else {
-        // Print to stdout
-        console.error(`\n# Configuration for ${client.name}`);
-        console.error(`# File: ${client.configPath}\n`);
-        console.log(JSON.stringify(config, null, 2));
-        console.error(`\n# Copy this to your ${client.name} config file`);
-        console.error(`# Or run with --output to write directly`);
-    }
-}
-
-main();