mcp-compose 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 unsafe9
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,257 @@
+# mcp-compose
+
+Orchestrate multiple MCP servers through a unified Streamable HTTP gateway. Converts stdio-based MCP servers to Streamable HTTP endpoints and manages them with pm2.
+
+## Installation
+
+No installation required - use `npx`. (RECOMMENDED)
+
+```bash
+npx -y mcp-compose status
+```
+
+You can add an alias to `~/.bashrc` or `~/.zshrc`:
+
+```bash
+alias mcp-compose='npx -y mcp-compose'
+```
+
+Or install globally:
+
+```bash
+npm install -g mcp-compose
+```
+
+## Quick Start
+
+```bash
+# Create config file (mcp-compose.json)
+mcp-compose up       # Start servers
+mcp-compose status   # Check status
+mcp-compose down     # Stop servers
+```
+
+## Configuration
+
+Create `mcp-compose.json` (or `mcp-compose.jsonc`) in:
+- Current directory
+- `~/.config/mcp-compose/`
+
+### Full Configuration Reference
+
+```json
+{
+  "settings": {
+    "portBase": 19100,
+    "claudeConfigPath": "~/.mcp.json",
+    "logLevel": "info"
+  },
+  "mcpServers": {
+    "my-server": { ... }
+  }
+}
+```
+
+### Settings
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `portBase` | number | `19100` | Starting port for stdio servers. Ports are allocated sequentially. |
+| `claudeConfigPath` | string | `~/.mcp.json` | Path to Claude Code's MCP config file. Supports `~` for home directory. |
+| `logLevel` | string | `"info"` | Default log level for supergateway. Options: `"debug"`, `"info"`, `"none"` |
+
+### Server Types
+
+#### stdio - Local Command Server
+
+Runs a local command and wraps it with supergateway to expose as HTTP.
+
+```json
+{
+  "my-server": {
+    "type": "stdio",
+    "command": "uvx",
+    "args": ["package@latest"],
+    "env": {
+      "API_KEY": "xxx"
+    },
+    "logLevel": "info",
+    "resourceLimits": {
+      "maxMemory": "512M",
+      "maxRestarts": 10,
+      "restartDelay": 1000
+    }
+  }
+}
+```
+
+| Property | Type | Required | Description |
+|----------|------|----------|-------------|
+| `type` | `"stdio"` | No | Auto-detected if `command` is present |
+| `command` | string | Yes | The command to execute |
+| `args` | string[] | No | Command arguments |
+| `env` | object | No | Environment variables |
+| `disabled` | boolean | No | Skip this server when starting |
+| `logLevel` | string | No | Override log level: `"debug"`, `"info"`, `"none"` |
+| `resourceLimits` | object | No | Process resource limits (see below) |
+
+#### sse/http - Remote Server
+
+Passthrough to remote MCP servers. No local process is started.
+
+```json
+{
+  "remote-server": {
+    "type": "sse",
+    "url": "https://example.com/sse"
+  }
+}
+```
+
+| Property | Type | Required | Description |
+|----------|------|----------|-------------|
+| `type` | `"sse"` or `"http"` | Yes | Server type |
+| `url` | string | Yes | Remote server URL |
+| `disabled` | boolean | No | Skip this server |
+
+### Resource Limits
+
+Control pm2 process management behavior for stdio servers.
+
+```json
+{
+  "resourceLimits": {
+    "maxMemory": "512M",
+    "maxRestarts": 10,
+    "restartDelay": 1000
+  }
+}
+```
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `maxMemory` | string or number | - | Memory limit before restart. String: `"512M"`, `"1G"`. Number: bytes. |
+| `maxRestarts` | number | `10` | Maximum restart attempts before giving up |
+| `restartDelay` | number | `1000` | Delay between restarts in milliseconds |
+
+### Disabling Servers
+
+Add `"disabled": true` to skip a server without removing its config:
+
+```json
+{
+  "my-server": {
+    "command": "uvx",
+    "args": ["some-package"],
+    "disabled": true
+  }
+}
+```
+
+### Example Configuration
+
+```json
+{
+  "settings": {
+    "portBase": 19100,
+    "claudeConfigPath": "~/.mcp.json",
+    "logLevel": "info"
+  },
+  "mcpServers": {
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "@anthropic/mcp-server-filesystem", "/home/user/documents"],
+      "resourceLimits": {
+        "maxMemory": "256M"
+      }
+    },
+    "github": {
+      "command": "uvx",
+      "args": ["mcp-server-github"],
+      "env": {
+        "GITHUB_TOKEN": "ghp_xxx"
+      }
+    },
+    "aws-docs": {
+      "type": "http",
+      "url": "https://mcp.aws.example.com/mcp"
+    },
+    "experimental": {
+      "command": "node",
+      "args": ["./my-experimental-server.js"],
+      "disabled": true
+    }
+  }
+}
+```
+
+## CLI Reference
+
+```
+mcp-compose up [servers...]      Start all or specific servers
+mcp-compose down [servers...]    Stop servers
+mcp-compose restart [servers...] Restart servers
+mcp-compose status               Show running servers
+mcp-compose logs [server] [-f]   View logs (follow with -f)
+mcp-compose startup              Enable auto-start on boot
+mcp-compose unstartup            Disable auto-start
+```
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `-c, --config <path>` | Specify config file path |
+| `-V, --version` | Show version |
+| `-h, --help` | Show help |
+
+### Examples
+
+```bash
+# Start all servers
+mcp-compose up
+
+# Start specific servers
+mcp-compose up github filesystem
+
+# Stop specific servers
+mcp-compose down github
+
+# Stop all servers
+mcp-compose down
+
+# Use custom config file
+mcp-compose -c ./custom-config.json up
+
+# View logs for specific server
+mcp-compose logs github
+
+# Follow all logs
+mcp-compose logs -f
+```
+
+## How It Works
+
+1. **stdio servers**: Started via pm2 using `supergateway` to expose Streamable HTTP endpoints
+2. **Remote servers**: Registered directly (no local process)
+3. **Config sync**: Auto-updates `~/.mcp.json` for Claude Code integration
+4. **Port allocation**: Automatically detects port conflicts and uses next available port
+
+Each stdio server gets an internal port starting from `portBase` (default 19100). If a port is in use, the next available port is automatically selected.
+
+## Features
+
+- **Automatic port conflict detection**: Skips ports in use and allocates next available
+- **Config validation**: Validates configuration structure with helpful error messages
+- **Progress feedback**: Shows real-time progress during server operations
+- **Resource limits**: Control memory usage and restart behavior per server
+- **Process management**: Auto-restart with configurable limits via pm2
+- **Non-destructive config sync**: Merges with existing Claude Code config
+
+## Requirements
+
+- Node.js 18+ (includes npx)
+
+## License
+
+MIT

package/dist/bin/mcp-compose.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=mcp-compose.d.ts.map

package/dist/bin/mcp-compose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-compose.d.ts","sourceRoot":"","sources":["../../bin/mcp-compose.ts"],"names":[],"mappings":""}

package/dist/bin/mcp-compose.js

@@ -0,0 +1,210 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { loadConfig, getStdioServers, getServerNames, allocatePorts, } from '../src/config.js';
+import { startServers, stopServers, stopAllManagedServers, restartServers, getStatus, streamLogs, setupStartup, saveProcessList, unstartup, } from '../src/pm2.js';
+import { syncToClaudeConfig, removeFromClaudeConfig } from '../src/sync.js';
+function formatProgress(event) {
+    const progress = event.total ? `[${String(event.current)}/${String(event.total)}]` : '';
+    switch (event.type) {
+        case 'checking_ports':
+            return `  ⋯ Checking port availability...`;
+        case 'port_skipped':
+            return `  ⚠ Port ${String(event.originalPort)} in use, using ${String(event.port)} instead`;
+        case 'starting':
+            return `  ${progress} Starting ${event.server}...`;
+        case 'started':
+            return `  ${progress} ✓ ${event.server} → http://localhost:${String(event.port)}/mcp`;
+        case 'stopping':
+            return `  ${progress} Stopping ${event.server}...`;
+        case 'stopped':
+            return `  ${progress} ✓ ${event.server} stopped`;
+        default:
+            return '';
+    }
+}
+function printProgress(event) {
+    const msg = formatProgress(event);
+    if (msg)
+        console.log(msg);
+}
+const program = new Command();
+function getConfigPath(cmd) {
+    return cmd.parent?.opts().config;
+}
+function handleError(err) {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error('Error:', message);
+    process.exit(1);
+}
+program
+    .name('mcp-compose')
+    .description('MCP server orchestration tool')
+    .version('0.1.0')
+    .option('-c, --config <path>', 'Path to config file');
+program
+    .command('up')
+    .description('Start MCP servers')
+    .argument('[servers...]', 'Specific servers to start (default: all)')
+    .action(async (servers, _options, cmd) => {
+    try {
+        const config = loadConfig(getConfigPath(cmd));
+        const { processPrefix } = config.settings;
+        const stdioServers = getStdioServers(config);
+        const filteredServers = servers.length > 0
+            ? stdioServers.filter((s) => servers.includes(s.name))
+            : stdioServers;
+        if (filteredServers.length === 0 && servers.length > 0) {
+            console.log('No stdio servers match the filter. Remote servers are synced directly.');
+        }
+        if (filteredServers.length > 0) {
+            console.log(`Starting ${String(filteredServers.length)} stdio server(s)...\n`);
+            // Check port availability and allocate ports
+            console.log('  ⋯ Checking port availability...');
+            const ports = await allocatePorts(filteredServers.length, config.settings.portBase, (originalPort, assignedPort) => {
+                console.log(`  ⚠ Port ${String(originalPort)} in use, using ${String(assignedPort)} instead`);
+            });
+            // Update servers with allocated ports
+            const serversWithPorts = filteredServers.map((server, i) => {
+                const port = ports[i];
+                if (port === undefined) {
+                    throw new Error(`Port allocation failed for server ${server.name}`);
+                }
+                return { ...server, internalPort: port };
+            });
+            console.log('');
+            await startServers(serversWithPorts, processPrefix, printProgress);
+        }
+        console.log('\nSyncing to Claude Code config...');
+        const syncResult = syncToClaudeConfig(config);
+        console.log(`  ✓ Updated ${syncResult.path}`);
+        console.log(`    Servers: ${syncResult.servers.join(', ')}`);
+        console.log('\nMCP servers are running via pm2.');
+        console.log('Use "mcp-compose status" to check status.');
+        console.log('Use "mcp-compose logs" to view logs.');
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+program
+    .command('down')
+    .description('Stop MCP servers')
+    .argument('[servers...]', 'Specific servers to stop (default: all)')
+    .action(async (servers, _options, cmd) => {
+    try {
+        const config = loadConfig(getConfigPath(cmd));
+        const { processPrefix } = config.settings;
+        if (servers.length > 0) {
+            const validServers = getServerNames(config, servers);
+            console.log(`Stopping ${String(validServers.length)} server(s)...\n`);
+            await stopServers(validServers, processPrefix, printProgress);
+        }
+        else {
+            console.log('Stopping all MCP servers...');
+            const count = await stopAllManagedServers();
+            console.log(`  ✓ Stopped ${String(count)} server(s)`);
+        }
+        console.log('\nRemoving from Claude Code config...');
+        const removeResult = removeFromClaudeConfig(config, servers.length > 0 ? servers : null);
+        if (removeResult.removed.length > 0) {
+            console.log(`  ✓ Removed: ${removeResult.removed.join(', ')}`);
+        }
+        else {
+            console.log('  (no changes)');
+        }
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+program
+    .command('restart')
+    .description('Restart MCP servers')
+    .argument('[servers...]', 'Specific servers to restart (default: all)')
+    .action(async (servers, _options, cmd) => {
+    try {
+        const config = loadConfig(getConfigPath(cmd));
+        const { processPrefix } = config.settings;
+        const stdioServers = getStdioServers(config);
+        const serverNames = servers.length > 0 ? servers : stdioServers.map((s) => s.name);
+        console.log(`Restarting ${String(serverNames.length)} server(s)...`);
+        await restartServers(serverNames, processPrefix);
+        for (const name of serverNames) {
+            console.log(`  ✓ ${name} restarted`);
+        }
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+program
+    .command('status')
+    .description('Show status of MCP servers')
+    .action(async () => {
+    try {
+        const status = await getStatus();
+        if (status.length === 0) {
+            console.log('No MCP servers running.');
+            return;
+        }
+        console.log('MCP Servers:\n');
+        console.log('  Name                 Status     PID      Memory     Restarts');
+        console.log('  ' + '-'.repeat(65));
+        for (const s of status) {
+            const memory = s.memory
+                ? `${String(Math.round(s.memory / 1024 / 1024))}MB`
+                : '-';
+            const statusColor = s.status === 'online' ? '\x1b[32m' : '\x1b[31m';
+            const reset = '\x1b[0m';
+            console.log(`  ${s.name.padEnd(20)} ${statusColor}${s.status.padEnd(10)}${reset} ${String(s.pid ?? '-').padEnd(8)} ${memory.padEnd(10)} ${String(s.restarts)}`);
+        }
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+program
+    .command('logs')
+    .description('View server logs')
+    .argument('[server]', 'Server name (default: all)')
+    .option('-f, --follow', 'Follow log output')
+    .action((server, _options, cmd) => {
+    try {
+        const config = loadConfig(getConfigPath(cmd));
+        const { processPrefix } = config.settings;
+        streamLogs(server, processPrefix);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+program
+    .command('startup')
+    .description('Enable auto-start on system boot')
+    .action(async () => {
+    try {
+        console.log('Setting up pm2 startup...');
+        await setupStartup();
+        console.log('\nSaving current process list...');
+        await saveProcessList();
+        console.log('\n✓ Auto-start enabled. MCP servers will start on boot.');
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+program
+    .command('unstartup')
+    .description('Disable auto-start on system boot')
+    .action(async () => {
+    try {
+        console.log('Removing pm2 startup...');
+        await unstartup();
+        console.log('\n✓ Auto-start disabled.');
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+program.parse();
+//# sourceMappingURL=mcp-compose.js.map

package/dist/bin/mcp-compose.js.map

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

package/dist/src/config.d.ts

@@ -0,0 +1,16 @@
+import type { RawConfig, NormalizedConfig, NamedStdioServer } from './types.js';
+export declare function expandPath(p: string): string;
+export declare function findConfigFile(startDir?: string): string | null;
+export declare function loadConfig(configPath?: string): NormalizedConfig;
+/**
+ * Check if a port is available
+ */
+export declare function isPortAvailable(port: number): Promise<boolean>;
+/**
+ * Allocate available ports for servers, skipping ports that are in use
+ */
+export declare function allocatePorts(serverCount: number, portBase: number, onPortSkipped?: (port: number, assignedPort: number) => void): Promise<number[]>;
+export declare function normalizeConfig(config: RawConfig): NormalizedConfig;
+export declare function getServerNames(config: NormalizedConfig, filter?: string[]): string[];
+export declare function getStdioServers(config: NormalizedConfig): NamedStdioServer[];
+//# sourceMappingURL=config.d.ts.map

package/dist/src/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,SAAS,EAET,gBAAgB,EAGhB,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAiBpB,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK5C;AAED,wBAAgB,cAAc,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAe9E;AAED,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,gBAAgB,CA0BhE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAa9D;AAkBD;;GAEG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,GAC3D,OAAO,CAAC,MAAM,EAAE,CAAC,CAcnB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,gBAAgB,CAyBnE;AA0CD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,gBAAgB,EACxB,MAAM,GAAE,MAAM,EAAO,GACpB,MAAM,EAAE,CAgBV;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,CAI5E"}