mcp-controller 0.4.0 → 0.4.1

package/README.md

@@ -5,7 +5,7 @@ A Model Context Protocol (MCP) server that acts as a proxy between MCP clients a
 ## Key Features
 
 - **🔧 Tool Filtering**: Selectively enable or disable specific tools from target MCP servers
-- **🔍 Transparent Proxying**: Forwards all other MCP protocol messages without modification  
+- **🔍 Transparent Proxying**: Forwards all other MCP protocol messages without modification
 - **⚡ Zero Configuration**: Works with any existing MCP server without changes
 - **🛡️ Access Control**: Control which tools clients can access for security and usability
 - **📦 Command Line Interface**: Start any MCP server through command arguments
@@ -15,8 +15,13 @@ A Model Context Protocol (MCP) server that acts as a proxy between MCP clients a
 ## Installation
 
 ```bash
-bun install
-bun run build
+curl -fsSL https://raw.githubusercontent.com/eli0shin/mcp-controller/main/install.sh | bash
+```
+
+Or install via npm:
+
+```bash
+npm install -g mcp-controller
 ```
 
 ## Usage
@@ -25,16 +30,16 @@ bun run build
 
 ```bash
 # Proxy to a local MCP server
-./mcp-controller bun run my-server.ts
+mcp-controller bun run my-server.ts
 
 # Proxy to an npm-distributed MCP server
-./mcp-controller @modelcontextprotocol/server-sequential-thinking
+mcp-controller @modelcontextprotocol/server-sequential-thinking
 
 # Proxy to a Python MCP server
-./mcp-controller python -m my_mcp_server
+mcp-controller python -m my_mcp_server
 
 # Proxy to any executable MCP server
-./mcp-controller node server.js --port 3000
+mcp-controller node server.js --port 3000
 ```
 
 ### Tool Filtering
@@ -43,13 +48,13 @@ Control which tools from the target server are exposed to clients:
 
 ```bash
 # Only allow specific tools (whitelist mode)
-./mcp-controller --enabled-tools file-read,file-write,search bun run my-server.ts
+mcp-controller --enabled-tools file-read,file-write,search bun run my-server.ts
 
-# Block specific tools (blacklist mode)  
-./mcp-controller --disabled-tools dangerous-tool,admin-commands python -m my_server
+# Block specific tools (blacklist mode)
+mcp-controller --disabled-tools dangerous-tool,admin-commands python -m my_server
 
 # Multiple tools (comma-separated, no spaces around commas)
-./mcp-controller --enabled-tools tool1,tool2,tool3 node server.js
+mcp-controller --enabled-tools tool1,tool2,tool3 node server.js
 ```
 
 ### Filtering Rules
@@ -63,30 +68,33 @@ Control which tools from the target server are exposed to clients:
 ## Use Cases
 
 ### Security & Access Control
+
 ```bash
 # Production environment - only allow safe read-only tools
-./mcp-controller --enabled-tools read-file,search,list-files my-server
+mcp-controller --enabled-tools read-file,search,list-files my-server
 
 # Development environment - block dangerous operations
-./mcp-controller --disabled-tools delete-file,format-disk,restart-system my-server
+mcp-controller --disabled-tools delete-file,format-disk,restart-system my-server
 ```
 
 ### Client-Specific Customization
+
 ```bash
 # For a documentation client - only text processing tools
-./mcp-controller --enabled-tools text-search,summarize,translate content-server
+mcp-controller --enabled-tools text-search,summarize,translate content-server
 
-# For an admin interface - block user-facing tools  
-./mcp-controller --disabled-tools user-chat,send-email,post-social admin-server
+# For an admin interface - block user-facing tools
+mcp-controller --disabled-tools user-chat,send-email,post-social admin-server
 ```
 
 ### Testing & Development
+
 ```bash
 # Test specific functionality by isolating tools
-./mcp-controller --enabled-tools database-query,cache-get test-server
+mcp-controller --enabled-tools database-query,cache-get test-server
 
 # Debug by excluding problematic tools
-./mcp-controller --disabled-tools flaky-api,slow-process debug-server
+mcp-controller --disabled-tools flaky-api,slow-process debug-server
 ```
 
 ## How it Works
@@ -107,7 +115,7 @@ MCP Client ↔ MCP Controller ↔ Target MCP Server
 ### Message Flow
 
 1. **Client → Controller → Target**: All requests forwarded transparently
-2. **Target → Controller → Client**: 
+2. **Target → Controller → Client**:
    - `tools/list` responses are filtered based on configuration
    - All other responses pass through unchanged
 
@@ -115,7 +123,7 @@ MCP Client ↔ MCP Controller ↔ Target MCP Server
 
 - ✅ **`tools/list` responses** - Tool arrays are filtered according to your settings
 - ❌ **Tool calls** - Individual tool invocations pass through (filtered tools simply won't be available)
-- ❌ **Resources** - Resource lists and access remain unchanged  
+- ❌ **Resources** - Resource lists and access remain unchanged
 - ❌ **Prompts** - Prompt functionality unaffected
 - ❌ **Other messages** - Initialization, capabilities, etc. pass through
 
@@ -124,6 +132,8 @@ MCP Client ↔ MCP Controller ↔ Target MCP Server
 ```bash
 Usage: mcp-controller [--enabled-tools <tool1,tool2,...>] [--disabled-tools <tool1,tool2,...>] <command> [args...]
 
+       mcp-controller update
+
 Options:
   --enabled-tools <tools>    Comma-separated list of tools to allow (whitelist mode)
   --disabled-tools <tools>   Comma-separated list of tools to block (blacklist mode)
@@ -140,15 +150,15 @@ The controller validates arguments at startup and will exit with helpful error m
 
 ```bash
 # Missing command
-$ ./mcp-controller --enabled-tools read
+$ mcp-controller --enabled-tools read
 Error: No target command specified
 
 # Both filtering modes
-$ ./mcp-controller --enabled-tools read --disabled-tools write bun server.ts  
+$ mcp-controller --enabled-tools read --disabled-tools write bun server.ts
 Error: --enabled-tools and --disabled-tools are mutually exclusive
 
 # Missing tool list
-$ ./mcp-controller --enabled-tools bun server.ts
+$ mcp-controller --enabled-tools bun server.ts
 Error: --enabled-tools requires a value
 ```
 
@@ -158,15 +168,21 @@ Error: --enabled-tools requires a value
 # Install dependencies
 bun install
 
-# Build the executable
+# Build release binaries
 bun run build
 
-# Run in development mode  
+# Run via wrapper against the local release build
+./bin/mcp-controller bun run tests/fixtures/mcp-server.ts
+
+# Run in development mode
 bun run dev <target-command>
 
 # Run tests (includes tool filtering tests)
 bun test
 
+# Update installed binary from GitHub Releases
+mcp-controller update
+
 # Lint and format
 bun run lint
 bun run format
@@ -177,4 +193,4 @@ bun run typecheck
 
 ## License
 
-MIT
+MIT

package/bin/mcp-controller

@@ -0,0 +1,56 @@
+#!/bin/sh
+set -e
+
+if [ -n "$MCP_CONTROLLER_BIN_PATH" ]; then
+    resolved="$MCP_CONTROLLER_BIN_PATH"
+else
+    script_path="$0"
+    while [ -L "$script_path" ]; do
+        link_target="$(readlink "$script_path")"
+        case "$link_target" in
+            /*) script_path="$link_target" ;;
+            *) script_path="$(dirname "$script_path")/$link_target" ;;
+        esac
+    done
+    script_dir="$(dirname "$script_path")"
+    script_dir="$(cd "$script_dir" && pwd)"
+
+    case "$(uname -s)" in
+        Darwin) platform="darwin" ;;
+        Linux) platform="linux" ;;
+        *) platform="$(uname -s | tr '[:upper:]' '[:lower:]')" ;;
+    esac
+
+    case "$(uname -m)" in
+        x86_64|amd64) arch="x64" ;;
+        aarch64|arm64) arch="arm64" ;;
+        *) arch="$(uname -m)" ;;
+    esac
+
+    resolved=""
+
+    candidate="$script_dir/mcp-controller-downloaded"
+    if [ -f "$candidate" ]; then
+        resolved="$candidate"
+    fi
+
+    if [ -z "$resolved" ]; then
+        name="mcp-controller-${platform}-${arch}"
+        current_dir="$script_dir"
+        while [ "$current_dir" != "/" ]; do
+            candidate="$current_dir/dist/$name/bin/mcp-controller"
+            if [ -f "$candidate" ]; then
+                resolved="$candidate"
+                break
+            fi
+            current_dir="$(dirname "$current_dir")"
+        done
+    fi
+
+    if [ -z "$resolved" ]; then
+        printf "Failed to find mcp-controller binary for your platform\n" >&2
+        exit 1
+    fi
+fi
+
+exec "$resolved" "$@"

package/bin/mcp-controller.cmd

@@ -0,0 +1,50 @@
+@echo off
+setlocal enabledelayedexpansion
+
+if defined MCP_CONTROLLER_BIN_PATH (
+    set "resolved=%MCP_CONTROLLER_BIN_PATH%"
+    goto :execute
+)
+
+set "script_dir=%~dp0"
+set "script_dir=%script_dir:~0,-1%"
+
+set "resolved="
+set "candidate=%script_dir%\mcp-controller-downloaded.exe"
+if exist "%candidate%" (
+    set "resolved=%candidate%"
+    goto :execute
+)
+
+if "%PROCESSOR_ARCHITECTURE%"=="AMD64" (
+    set "arch=x64"
+) else if "%PROCESSOR_ARCHITECTURE%"=="ARM64" (
+    set "arch=arm64"
+) else (
+    set "arch=x64"
+)
+
+set "name=mcp-controller-windows-!arch!"
+set "current_dir=%script_dir%"
+
+:search_loop
+set "candidate=%current_dir%\dist\%name%\bin\mcp-controller.exe"
+if exist "%candidate%" (
+    set "resolved=%candidate%"
+    goto :execute
+)
+
+for %%i in ("%current_dir%") do set "parent_dir=%%~dpi"
+set "parent_dir=%parent_dir:~0,-1%"
+
+if "%current_dir%"=="%parent_dir%" goto :not_found
+set "current_dir=%parent_dir%"
+goto :search_loop
+
+:not_found
+echo Failed to find mcp-controller binary for your platform >&2
+exit /b 1
+
+:execute
+start /b /wait "" "%resolved%" %*
+exit /b %ERRORLEVEL%

package/package.json

@@ -1,53 +1,21 @@
 {
   "name": "mcp-controller",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "MCP server proxy that enables controlling availability of tools.",
-  "type": "module",
-  "bin": {
-    "mcp-controller": "mcp-controller"
-  },
-  "files": [
-    "README.md",
-    "package.json",
-    "bun.lock",
-    "mcp-controller"
-  ],
-  "scripts": {
-    "build": "bun build src/cli.ts --compile --outfile mcp-controller",
-    "dev": "bun run src/cli.ts",
-    "typecheck": "bun tsc --noEmit",
-    "lint": "eslint .",
-    "lint:fix": "eslint . --fix",
-    "format": "prettier --check .",
-    "format:fix": "prettier --write .",
-    "test": "bun test",
-    "test:watch": "bun test tests/ --watch",
-    "prepublish": "bun test && bun run build"
-  },
-  "devDependencies": {
-    "@changesets/changelog-github": "^0.5.2",
-    "@changesets/cli": "^2.29.8",
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "@total-typescript/ts-reset": "^0.6.1",
-    "@types/node": "^22.9.0",
-    "bun-types": "^1.1.34",
-    "eslint": "^9.15.0",
-    "eslint-for-ai": "^1.0.8",
-    "prettier": "^3.3.3",
-    "typescript": "^5.6.3",
-    "zod": "^3.23.8"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "proxy",
-    "json-rpc",
-    "cli"
-  ],
-  "author": "@eli0shin",
-  "license": "MIT",
   "repository": {
     "type": "git",
     "url": "https://github.com/eli0shin/mcp-controller"
+  },
+  "bugs": {
+    "url": "https://github.com/eli0shin/mcp-controller/issues"
+  },
+  "homepage": "https://github.com/eli0shin/mcp-controller#readme",
+  "license": "MIT",
+  "bin": {
+    "mcp-controller": "./bin/mcp-controller"
+  },
+  "scripts": {
+    "preinstall": "node ./preinstall.mjs",
+    "postinstall": "node ./postinstall.mjs"
   }
 }

package/postinstall.mjs

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { fileURLToPath } from 'url';
+import { createRequire } from 'module';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+const REPO = 'eli0shin/mcp-controller';
+
+function shouldSkipPostinstall() {
+  const packageRoot = path.join(__dirname, '..');
+  const srcDir = path.join(packageRoot, 'src');
+  if (fs.existsSync(srcDir)) {
+    console.log('Skipping postinstall (running from source)');
+    return true;
+  }
+  return false;
+}
+
+function detectPlatformAndArch() {
+  let platform;
+  switch (os.platform()) {
+    case 'darwin':
+      platform = 'darwin';
+      break;
+    case 'linux':
+      platform = 'linux';
+      break;
+    case 'win32':
+      platform = 'windows';
+      break;
+    default:
+      platform = os.platform();
+  }
+
+  let arch;
+  switch (os.arch()) {
+    case 'x64':
+      arch = 'x64';
+      break;
+    case 'arm64':
+      arch = 'arm64';
+      break;
+    default:
+      arch = os.arch();
+  }
+
+  return { platform, arch };
+}
+
+function getDownloadedBinaryPath() {
+  const { platform } = detectPlatformAndArch();
+  const binary =
+    platform === 'windows'
+      ? 'mcp-controller-downloaded.exe'
+      : 'mcp-controller-downloaded';
+  return path.join(__dirname, '..', 'bin', binary);
+}
+
+async function downloadLatestBinary() {
+  const { platform, arch } = detectPlatformAndArch();
+  const asset =
+    platform === 'windows'
+      ? `mcp-controller-${platform}-${arch}.exe`
+      : `mcp-controller-${platform}-${arch}`;
+  const url = `https://github.com/${REPO}/releases/latest/download/${asset}`;
+  const response = await fetch(url, {
+    headers: {
+      'User-Agent': 'mcp-controller',
+    },
+  });
+
+  if (!response.ok) {
+    throw new Error(`Failed to download ${url}: ${response.status}`);
+  }
+
+  const targetPath = getDownloadedBinaryPath();
+  fs.mkdirSync(path.dirname(targetPath), { recursive: true });
+  const arrayBuffer = await response.arrayBuffer();
+  fs.writeFileSync(targetPath, Buffer.from(arrayBuffer));
+
+  if (platform !== 'windows') {
+    fs.chmodSync(targetPath, 0o755);
+  }
+
+  console.log(`Downloaded binary: ${targetPath}`);
+}
+
+async function regenerateWindowsCmdWrappers() {
+  console.log('Windows + npm: Rebuilding bin links');
+
+  try {
+    const { execSync } = require('child_process');
+    const pkgPath = path.join(__dirname, '..');
+
+    const isGlobal =
+      process.env.npm_config_global === 'true' ||
+      pkgPath.includes(path.join('npm', 'node_modules'));
+
+    const cmd = `npm rebuild mcp-controller --ignore-scripts${isGlobal ? ' -g' : ''}`;
+    const opts = {
+      stdio: 'inherit',
+      shell: true,
+      ...(isGlobal ? {} : { cwd: path.join(pkgPath, '..', '..') }),
+    };
+
+    execSync(cmd, opts);
+    console.log('Successfully rebuilt npm bin links');
+  } catch (error) {
+    console.error('Error rebuilding npm links:', error.message);
+  }
+}
+
+async function main() {
+  if (shouldSkipPostinstall()) {
+    return;
+  }
+
+  try {
+    await downloadLatestBinary();
+
+    if (
+      os.platform() === 'win32' &&
+      process.env.npm_config_user_agent?.startsWith('npm')
+    ) {
+      await regenerateWindowsCmdWrappers();
+    }
+  } catch (error) {
+    console.error('Failed to install release binary:', error.message);
+    process.exit(1);
+  }
+}
+
+try {
+  await main();
+} catch (error) {
+  console.error('Postinstall error:', error.message);
+  process.exit(0);
+}

package/preinstall.mjs

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+function main() {
+  if (os.platform() !== 'win32') {
+    console.log('Non-Windows platform, skipping preinstall');
+    return;
+  }
+
+  console.log('Windows: Modifying package.json bin entry');
+
+  const packageJsonPath = path.join(__dirname, '..', 'package.json');
+  const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+
+  packageJson.bin = {
+    'mcp-controller': './bin/mcp-controller.cmd',
+  };
+
+  fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
+  console.log('Updated package.json bin to use mcp-controller.cmd');
+
+  const unixScript = path.join(__dirname, '..', 'bin', 'mcp-controller');
+  if (fs.existsSync(unixScript)) {
+    fs.unlinkSync(unixScript);
+  }
+}
+
+try {
+  main();
+} catch (error) {
+  console.error('Preinstall error:', error.message);
+  process.exit(0);
+}