@khanglvm/tool-hub-mcp 1.0.0

package/README.md

@@ -0,0 +1,87 @@
+# @khanglvm/tool-hub-mcp
+
+**Serverless MCP Aggregator** - Reduce AI context token consumption by 60-97%
+
+## Quick Start
+
+```bash
+# Zero-install usage (recommended)
+npx @khanglvm/tool-hub-mcp setup
+npx @khanglvm/tool-hub-mcp serve
+npx @khanglvm/tool-hub-mcp benchmark
+```
+
+Also works with other JS package runners:
+```bash
+bunx @khanglvm/tool-hub-mcp setup
+pnpm dlx @khanglvm/tool-hub-mcp setup
+yarn dlx @khanglvm/tool-hub-mcp setup
+```
+
+## What It Does
+
+When using multiple MCP servers with AI clients (Claude Code, OpenCode, etc.), each server exposes all its tools to the AI. With 5+ servers, you can easily consume **25,000+ tokens** just for tool definitions.
+
+`tool-hub-mcp` acts as a single MCP endpoint that exposes only **5 meta-tools**:
+
+| Tool | Description |
+|------|-------------|
+| `hub_list` | List all registered MCP servers |
+| `hub_discover` | Get tools from a specific server |
+| `hub_search` | Search for tools across servers |
+| `hub_execute` | Execute a tool from a server |
+| `hub_help` | Get detailed help for a tool |
+
+**Result:** ~461 tokens instead of 1,200-25,000+ = **61-97% reduction**
+
+## Commands
+
+```bash
+# Import configs from AI CLI tools (Claude Code, OpenCode, etc.)
+npx @khanglvm/tool-hub-mcp setup
+
+# Run as MCP server (for AI client integration)
+npx @khanglvm/tool-hub-mcp serve
+
+# Add MCP servers manually
+npx @khanglvm/tool-hub-mcp add jira --command npx --arg -y --arg @lvmk/jira-mcp
+
+# Run token efficiency benchmark
+npx @khanglvm/tool-hub-mcp benchmark
+
+# Run speed/latency benchmark
+npx @khanglvm/tool-hub-mcp benchmark speed
+```
+
+## MCP Client Configuration
+
+Add to your AI client config:
+
+**Claude Code:**
+```bash
+claude mcp add tool-hub -- npx @khanglvm/tool-hub-mcp serve
+```
+
+**Manual JSON config:**
+```json
+{
+  "mcpServers": {
+    "tool-hub": {
+      "command": "npx",
+      "args": ["@khanglvm/tool-hub-mcp", "serve"]
+    }
+  }
+}
+```
+
+## Platforms
+
+This package automatically installs the correct binary for your platform:
+
+- macOS (Apple Silicon & Intel)
+- Linux (x64 & ARM64)
+- Windows (x64)
+
+## License
+
+MIT © khanglvm

package/cli.js

@@ -0,0 +1,130 @@
+#!/usr/bin/env node
+
+/**
+ * CLI wrapper for tool-hub-mcp Go binary.
+ * Locates the platform-specific binary from optionalDependencies and spawns it.
+ * 
+ * Architecture: Thin wrapper that passes through all args and stdio to the Go binary.
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
+
+/**
+ * Get the platform-specific package name based on current OS and architecture.
+ * @returns {string} Package name like '@khanglvm/tool-hub-mcp-darwin-arm64'
+ */
+function getPlatformPackageName() {
+    const platform = os.platform();
+    const arch = os.arch();
+
+    // Map Node.js platform/arch to our package naming convention
+    const platformMap = {
+        'darwin': 'darwin',
+        'linux': 'linux',
+        'win32': 'win32'
+    };
+
+    const archMap = {
+        'arm64': 'arm64',
+        'x64': 'x64',
+        'x86_64': 'x64'  // Fallback
+    };
+
+    const mappedPlatform = platformMap[platform];
+    const mappedArch = archMap[arch];
+
+    if (!mappedPlatform || !mappedArch) {
+        throw new Error(`Unsupported platform: ${platform}-${arch}`);
+    }
+
+    return `@khanglvm/tool-hub-mcp-${mappedPlatform}-${mappedArch}`;
+}
+
+/**
+ * Find the binary path from the installed platform package.
+ * Searches in node_modules relative to this script.
+ * @returns {string|null} Path to binary or null if not found
+ */
+function findBinaryFromPackage() {
+    const packageName = getPlatformPackageName();
+    const binaryName = os.platform() === 'win32' ? 'tool-hub-mcp.exe' : 'tool-hub-mcp';
+
+    // Get platform directory name (e.g., 'darwin-arm64')
+    const platformDir = packageName.replace('@khanglvm/tool-hub-mcp-', '');
+
+    // Search locations (support various node_modules layouts + local dev)
+    const searchPaths = [
+        // Local development (platforms subdirectory)
+        path.join(__dirname, 'platforms', platformDir, 'bin', binaryName),
+        // Standard node_modules
+        path.join(__dirname, 'node_modules', packageName, 'bin', binaryName),
+        // Hoisted (pnpm, yarn workspaces)
+        path.join(__dirname, '..', packageName, 'bin', binaryName),
+        // Global install
+        path.join(__dirname, '..', '..', packageName, 'bin', binaryName),
+    ];
+
+    for (const searchPath of searchPaths) {
+        if (fs.existsSync(searchPath)) {
+            return searchPath;
+        }
+    }
+
+    return null;
+}
+
+/**
+ * Find binary downloaded by postinstall fallback.
+ * @returns {string|null} Path to binary or null if not found
+ */
+function findDownloadedBinary() {
+    const binaryName = os.platform() === 'win32' ? 'tool-hub-mcp.exe' : 'tool-hub-mcp';
+    const downloadPath = path.join(__dirname, 'bin', binaryName);
+
+    if (fs.existsSync(downloadPath)) {
+        return downloadPath;
+    }
+
+    return null;
+}
+
+/**
+ * Main entry point - find binary and spawn with all arguments.
+ */
+function main() {
+    // Try platform package first, then fallback to downloaded binary
+    let binaryPath = findBinaryFromPackage() || findDownloadedBinary();
+
+    if (!binaryPath) {
+        console.error('Error: tool-hub-mcp binary not found.');
+        console.error('This may happen if:');
+        console.error('  1. optionalDependencies were disabled during install');
+        console.error('  2. postinstall script failed to download the binary');
+        console.error('');
+        console.error('Try reinstalling: npm install @khanglvm/tool-hub-mcp');
+        console.error('Or download manually from: https://github.com/khanglvm/tool-hub-mcp/releases');
+        process.exit(1);
+    }
+
+    // Spawn the binary with all arguments passed through
+    const child = spawn(binaryPath, process.argv.slice(2), {
+        stdio: 'inherit',  // Pass through stdin/stdout/stderr
+        shell: false
+    });
+
+    // Forward exit code
+    child.on('close', (code) => {
+        process.exit(code ?? 0);
+    });
+
+    // Handle spawn errors
+    child.on('error', (err) => {
+        console.error(`Failed to start tool-hub-mcp: ${err.message}`);
+        process.exit(1);
+    });
+}
+
+main();

package/package.json

@@ -0,0 +1,45 @@
+{
+    "name": "@khanglvm/tool-hub-mcp",
+    "version": "1.0.0",
+    "description": "Serverless MCP Aggregator - Reduce AI context token consumption by 60-97%",
+    "bin": {
+        "tool-hub-mcp": "./cli.js"
+    },
+    "main": "./cli.js",
+    "files": [
+        "cli.js",
+        "postinstall.js"
+    ],
+    "scripts": {
+        "postinstall": "node postinstall.js"
+    },
+    "optionalDependencies": {
+        "@khanglvm/tool-hub-mcp-darwin-arm64": "1.0.0",
+        "@khanglvm/tool-hub-mcp-darwin-x64": "1.0.0",
+        "@khanglvm/tool-hub-mcp-linux-x64": "1.0.0",
+        "@khanglvm/tool-hub-mcp-linux-arm64": "1.0.0",
+        "@khanglvm/tool-hub-mcp-win32-x64": "1.0.0"
+    },
+    "keywords": [
+        "mcp",
+        "model-context-protocol",
+        "ai",
+        "claude",
+        "opencode",
+        "aggregator",
+        "serverless"
+    ],
+    "author": "khanglvm",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/khanglvm/tool-hub-mcp.git"
+    },
+    "bugs": {
+        "url": "https://github.com/khanglvm/tool-hub-mcp/issues"
+    },
+    "homepage": "https://github.com/khanglvm/tool-hub-mcp#readme",
+    "engines": {
+        "node": ">=18"
+    }
+}

package/postinstall.js

@@ -0,0 +1,197 @@
+#!/usr/bin/env node
+
+/**
+ * Postinstall fallback for tool-hub-mcp.
+ * Downloads the Go binary from GitHub Releases if optionalDependencies were not installed.
+ * 
+ * This handles environments where:
+ * - optionalDependencies are disabled (some CI environments)
+ * - Package manager fails to resolve platform-specific packages
+ */
+
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { execSync } = require('child_process');
+
+// Configuration
+const GITHUB_REPO = 'khanglvm/tool-hub-mcp';
+const BINARY_NAME = 'tool-hub-mcp';
+
+/**
+ * Get platform suffix for GitHub release assets.
+ * @returns {string} Suffix like 'Darwin-arm64' or 'Linux-x86_64'
+ */
+function getPlatformSuffix() {
+    const platform = os.platform();
+    const arch = os.arch();
+
+    const platformMap = {
+        'darwin': 'Darwin',
+        'linux': 'Linux',
+        'win32': 'Windows'
+    };
+
+    const archMap = {
+        'arm64': 'arm64',
+        'x64': 'x86_64'
+    };
+
+    const mappedPlatform = platformMap[platform];
+    const mappedArch = archMap[arch];
+
+    if (!mappedPlatform || !mappedArch) {
+        throw new Error(`Unsupported platform: ${platform}-${arch}`);
+    }
+
+    const suffix = `${mappedPlatform}-${mappedArch}`;
+    return platform === 'win32' ? `${suffix}.exe` : suffix;
+}
+
+/**
+ * Check if platform package binary already exists.
+ * @returns {boolean} True if binary found in optionalDependencies
+ */
+function hasPlatformBinary() {
+    const platform = os.platform();
+    const arch = os.arch();
+
+    const archMap = { 'arm64': 'arm64', 'x64': 'x64' };
+    const platformMap = { 'darwin': 'darwin', 'linux': 'linux', 'win32': 'win32' };
+
+    const packageName = `@khanglvm/tool-hub-mcp-${platformMap[platform]}-${archMap[arch]}`;
+    const binaryName = platform === 'win32' ? `${BINARY_NAME}.exe` : BINARY_NAME;
+
+    const searchPaths = [
+        path.join(__dirname, 'node_modules', packageName, 'bin', binaryName),
+        path.join(__dirname, '..', packageName, 'bin', binaryName),
+        path.join(__dirname, '..', '..', packageName, 'bin', binaryName),
+    ];
+
+    return searchPaths.some(p => fs.existsSync(p));
+}
+
+/**
+ * Follow redirects and download file.
+ * @param {string} url - URL to download
+ * @param {string} dest - Destination file path
+ * @returns {Promise<void>}
+ */
+function downloadFile(url, dest) {
+    return new Promise((resolve, reject) => {
+        const file = fs.createWriteStream(dest);
+
+        const request = (url) => {
+            https.get(url, (response) => {
+                // Handle redirects (GitHub releases use 302)
+                if (response.statusCode === 301 || response.statusCode === 302) {
+                    file.close();
+                    fs.unlinkSync(dest);
+                    request(response.headers.location);
+                    return;
+                }
+
+                if (response.statusCode !== 200) {
+                    file.close();
+                    fs.unlinkSync(dest);
+                    reject(new Error(`HTTP ${response.statusCode}: Failed to download ${url}`));
+                    return;
+                }
+
+                response.pipe(file);
+                file.on('finish', () => {
+                    file.close();
+                    resolve();
+                });
+            }).on('error', (err) => {
+                file.close();
+                fs.unlinkSync(dest);
+                reject(err);
+            });
+        };
+
+        request(url);
+    });
+}
+
+/**
+ * Get the latest release version from GitHub API.
+ * @returns {Promise<string>} Version tag like 'v1.0.0'
+ */
+function getLatestVersion() {
+    return new Promise((resolve, reject) => {
+        const options = {
+            hostname: 'api.github.com',
+            path: `/repos/${GITHUB_REPO}/releases/latest`,
+            headers: { 'User-Agent': 'tool-hub-mcp-installer' }
+        };
+
+        https.get(options, (response) => {
+            let data = '';
+            response.on('data', chunk => data += chunk);
+            response.on('end', () => {
+                try {
+                    const release = JSON.parse(data);
+                    if (release.tag_name) {
+                        resolve(release.tag_name);
+                    } else {
+                        reject(new Error('No releases found'));
+                    }
+                } catch (e) {
+                    reject(e);
+                }
+            });
+        }).on('error', reject);
+    });
+}
+
+/**
+ * Main postinstall logic.
+ */
+async function main() {
+    // Skip if platform binary already installed via optionalDependencies
+    if (hasPlatformBinary()) {
+        console.log('tool-hub-mcp: Binary found from optionalDependencies ✓');
+        return;
+    }
+
+    console.log('tool-hub-mcp: optionalDependencies not available, downloading from GitHub...');
+
+    try {
+        // Get latest version
+        const version = await getLatestVersion();
+        console.log(`tool-hub-mcp: Downloading version ${version}...`);
+
+        // Prepare download
+        const suffix = getPlatformSuffix();
+        const binaryName = os.platform() === 'win32' ? `${BINARY_NAME}.exe` : BINARY_NAME;
+        const downloadUrl = `https://github.com/${GITHUB_REPO}/releases/download/${version}/${BINARY_NAME}-${suffix}`;
+
+        // Create bin directory
+        const binDir = path.join(__dirname, 'bin');
+        if (!fs.existsSync(binDir)) {
+            fs.mkdirSync(binDir, { recursive: true });
+        }
+
+        const destPath = path.join(binDir, binaryName);
+
+        // Download binary
+        await downloadFile(downloadUrl, destPath);
+
+        // Make executable (Unix only)
+        if (os.platform() !== 'win32') {
+            fs.chmodSync(destPath, 0o755);
+        }
+
+        console.log('tool-hub-mcp: Binary downloaded and installed ✓');
+
+    } catch (error) {
+        console.error(`tool-hub-mcp: Failed to download binary: ${error.message}`);
+        console.error('You can manually download from: https://github.com/khanglvm/tool-hub-mcp/releases');
+        // Don't fail the install - user can still manually download
+        process.exit(0);
+    }
+}
+
+main();