mcp-twin 1.2.0

package/README.md

@@ -0,0 +1,306 @@
+# MCP Twin
+
+> Zero-downtime MCP server updates for **any** MCP client
+
+**⚡ Powered by [Prax Chat](https://prax.chat)**
+
+Works with: **Claude Desktop** · **Claude Code** · **VS Code** · **Cursor** · **Cline** · **Windsurf**
+
+Stop restarting your AI assistant every time you change your MCP server.
+
+<p align="center">
+  <img src="https://github.com/nothinginfinity/mcp-twin/raw/main/demo.gif" alt="MCP Twin Demo" width="600">
+</p>
+
+## Demo
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│ $ /twin start inbox-collab                                      │
+│                                                                 │
+│ Started twins for inbox-collab                                  │
+│   Server A: port 8101 ● running  ← ACTIVE                       │
+│   Server B: port 8102 ● running    standby                      │
+│                                                                 │
+├─────────────────────────────────────────────────────────────────┤
+│ $ vim server.py                    # Edit your MCP server       │
+│ $ /twin reload inbox-collab                                     │
+│                                                                 │
+│ Reloaded inbox-collab standby                                   │
+│   Standby (B): port 8102                                        │
+│   Health: passing ●                                             │
+│                                                                 │
+├─────────────────────────────────────────────────────────────────┤
+│ $ /twin swap inbox-collab                                       │
+│                                                                 │
+│ Swapped inbox-collab                                            │
+│   Previous: A (port 8101)                                       │
+│   Now active: B (port 8102) ✓                                   │
+│                                                                 │
+│ Your changes are now live! No restart needed.                   │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+## The Problem
+
+Every time you edit an MCP server, you have to:
+1. Stop Claude Code
+2. Restart the MCP server
+3. Restart Claude Code
+4. Lose your conversation context
+
+Sound familiar? **MCP Twin fixes this.**
+
+## The Solution
+
+MCP Twin runs two instances of your MCP server simultaneously:
+- **Server A**: Active (receiving traffic)
+- **Server B**: Standby (ready to take over)
+
+When you edit code:
+1. Reload standby with new code
+2. Swap traffic to standby
+3. Keep working - zero downtime!
+
+## Quick Start
+
+```bash
+# Start twins for your MCP server
+/twin start my-server
+
+# Edit your server code...
+
+# Reload standby with changes
+/twin reload my-server
+
+# Switch traffic to new version
+/twin swap my-server
+
+# Done! No restart needed.
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `/twin start [server]` | Start twin servers |
+| `/twin stop [server]` | Stop twin servers |
+| `/twin reload <server>` | Reload standby with new code |
+| `/twin swap <server>` | Switch traffic to standby |
+| `/twin status [server]` | Show twin status |
+| `/twin detect` | Auto-detect MCP servers |
+| `/twin help` | Show help |
+
+## Example Workflow
+
+```
+$ /twin start inbox-collab
+
+Started twins for inbox-collab
+
+  Server A: port 8101 ● running
+  Server B: port 8102 ● running
+  Active: A
+
+Edit your code, then: /twin reload inbox-collab
+```
+
+```
+$ /twin reload inbox-collab
+
+Reloaded inbox-collab standby
+
+  standby (b) on port 8102
+  Health: passing ●
+  Reload count: 1
+
+Run: /twin swap inbox-collab
+```
+
+```
+$ /twin swap inbox-collab
+
+Swapped inbox-collab
+
+  Previous: a (port 8101)
+  Now active: b (port 8102)
+
+Your changes are now live!
+```
+
+## Auto-Detection
+
+MCP Twin automatically detects servers from your Claude config:
+
+```
+$ /twin detect
+
+Detected 3 MCP servers:
+  - inbox-collab
+  - phi-proxy
+  - zti-server
+
+3 configured for twins.
+```
+
+## Installation
+
+### Universal CLI (any client)
+```bash
+# Install globally
+npm install -g mcp-twin
+
+# Or run directly with npx
+npx mcp-twin start my-server
+```
+
+### Claude Code Plugin
+```
+/install mcp-twin
+```
+
+### From Source
+```bash
+git clone https://github.com/nothinginfinity/mcp-twin
+cd mcp-twin
+npm install
+npm run build
+npm link  # Makes 'mcp-twin' command available globally
+```
+
+## Supported Clients
+
+MCP Twin auto-detects servers from all major MCP clients:
+
+| Client | Config Location |
+|--------|-----------------|
+| Claude Desktop | `~/Library/Application Support/Claude/` |
+| Claude Code | `~/.claude/` |
+| VS Code | `.vscode/mcp.json` |
+| Cursor | `~/.cursor/mcp.json` |
+| Windsurf | `~/.windsurf/mcp.json` |
+| Cline | VS Code settings |
+
+```bash
+# Auto-detect all configured servers
+mcp-twin detect
+
+# Detected 3 MCP servers:
+#   - inbox-collab (from Claude Code)
+#   - my-api (from Cursor)
+#   - data-tools (from VS Code)
+```
+
+## Configuration
+
+Config stored at `~/.mcp-twin/config.json`:
+
+```json
+{
+  "servers": {
+    "my-server": {
+      "script": "/path/to/server.py",
+      "ports": [8101, 8102],
+      "python": "python3"
+    }
+  },
+  "settings": {
+    "startupWait": 2000,
+    "shutdownTimeout": 5000
+  }
+}
+```
+
+## How It Works
+
+```
+┌─────────────────────────────────────────┐
+│           Claude Code                    │
+│              │                           │
+│              ▼                           │
+│    ┌─────────────────┐                  │
+│    │   MCP Client    │                  │
+│    └────────┬────────┘                  │
+│             │                            │
+│       ┌─────┴─────┐                     │
+│       ▼           ▼                      │
+│   ┌───────┐   ┌───────┐                 │
+│   │ MCP-A │   │ MCP-B │                 │
+│   │:8101  │   │:8102  │                 │
+│   │ACTIVE │   │STANDBY│                 │
+│   └───────┘   └───────┘                 │
+│                                          │
+└─────────────────────────────────────────┘
+```
+
+1. **Start**: Both A and B running, A is active
+2. **Edit**: Change your server code
+3. **Reload**: Stop B, start B with new code
+4. **Swap**: Route traffic to B, A becomes standby
+5. **Repeat**: Next edit reloads A, swap back
+
+## Server Requirements
+
+Your MCP server must support HTTP mode with these flags:
+
+```bash
+python3 server.py --http --port 8101
+```
+
+The server should expose:
+- `POST /mcp` - JSON-RPC 2.0 endpoint for MCP protocol
+- `GET /health` - Health check endpoint (returns 200 OK)
+
+### Adding HTTP Mode to Your Server
+
+Add this to your MCP server's main block:
+
+```python
+if __name__ == "__main__":
+    import argparse
+
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--http", action="store_true", help="Run as HTTP server")
+    parser.add_argument("--port", type=int, default=8101, help="HTTP port")
+    args = parser.parse_args()
+
+    if args.http:
+        run_http_server(args.port)  # Your HTTP server implementation
+    else:
+        main()  # Original stdio mode
+```
+
+See the [example implementation](examples/http-server.py) for a complete template.
+
+## Pro Features (Coming Soon)
+
+**[Prax Chat Pro](https://prax.chat/mcp-twin/pro)** - Enterprise MCP management
+
+| Feature | Free | Pro |
+|---------|------|-----|
+| Twin servers | ✅ | ✅ |
+| Manual reload/swap | ✅ | ✅ |
+| Auto-reload on save | ❌ | ✅ |
+| Health dashboard | ❌ | ✅ |
+| Rollback history | ❌ | ✅ |
+| Slack/Discord alerts | ❌ | ✅ |
+| Team sharing | ❌ | ✅ |
+| Priority support | ❌ | ✅ |
+
+[Join the waitlist →](https://prax.chat/mcp-twin/pro)
+
+## License
+
+MIT
+
+## Credits
+
+Built with ❤️ by [Prax Chat](https://prax.chat)
+
+---
+
+<p align="center">
+  <a href="https://prax.chat">
+    <img src="https://img.shields.io/badge/Powered%20by-Prax%20Chat-blue?style=for-the-badge" alt="Powered by Prax Chat">
+  </a>
+</p>

package/dist/cli.d.ts

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+/**
+ * MCP Twin CLI - Universal zero-downtime MCP server management
+ *
+ * Works with ANY MCP client: Claude Desktop, VS Code, Cursor, Cline, etc.
+ *
+ * Usage:
+ *   npx mcp-twin start my-server
+ *   npx mcp-twin reload my-server
+ *   npx mcp-twin swap my-server
+ *   npx mcp-twin status
+ *
+ * Powered by Prax Chat - https://prax.chat
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG"}

package/dist/cli.js

@@ -0,0 +1,215 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * MCP Twin CLI - Universal zero-downtime MCP server management
+ *
+ * Works with ANY MCP client: Claude Desktop, VS Code, Cursor, Cline, etc.
+ *
+ * Usage:
+ *   npx mcp-twin start my-server
+ *   npx mcp-twin reload my-server
+ *   npx mcp-twin swap my-server
+ *   npx mcp-twin status
+ *
+ * Powered by Prax Chat - https://prax.chat
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const twin_manager_1 = require("./twin-manager");
+const config_detector_1 = require("./config-detector");
+const PRAX_FOOTER = '\n─────────────────────────────────────────\n⚡ Powered by Prax Chat | prax.chat/mcp-twin';
+const VERSION = '1.2.0';
+async function main() {
+    const args = process.argv.slice(2);
+    const command = args[0]?.toLowerCase();
+    const serverName = args[1];
+    const manager = (0, twin_manager_1.getTwinManager)();
+    switch (command) {
+        case 'start': {
+            if (!serverName) {
+                const status = await manager.status();
+                console.log('Available servers:');
+                (status.available || []).forEach((s) => console.log(`  - ${s}`));
+                console.log('\nUsage: mcp-twin start <server-name>');
+                break;
+            }
+            const result = await manager.startTwins(serverName);
+            if (result.ok) {
+                console.log(`✓ Started twins for ${serverName}`);
+                console.log(`  Server A: port ${result.portA} (${result.statusA})`);
+                console.log(`  Server B: port ${result.portB} (${result.statusB})`);
+                console.log(`  Active: A`);
+            }
+            else {
+                console.error(`✗ Failed: ${result.error}`);
+                process.exit(1);
+            }
+            console.log(PRAX_FOOTER);
+            break;
+        }
+        case 'stop': {
+            if (!serverName) {
+                console.log('Usage: mcp-twin stop <server-name>');
+                console.log('       mcp-twin stop --all');
+                break;
+            }
+            if (serverName === '--all') {
+                const status = await manager.status();
+                for (const name of Object.keys(status.twins || {})) {
+                    await manager.stopTwins(name);
+                    console.log(`✓ Stopped ${name}`);
+                }
+            }
+            else {
+                const result = await manager.stopTwins(serverName);
+                if (result.ok) {
+                    console.log(`✓ Stopped ${serverName} twins`);
+                }
+                else {
+                    console.error(`✗ Failed: ${result.error}`);
+                    process.exit(1);
+                }
+            }
+            break;
+        }
+        case 'reload': {
+            if (!serverName) {
+                console.log('Usage: mcp-twin reload <server-name>');
+                break;
+            }
+            console.log(`Reloading ${serverName} standby...`);
+            const result = await manager.reloadStandby(serverName);
+            if (result.ok) {
+                console.log(`✓ Reloaded ${result.reloaded}`);
+                console.log(`  Health: ${result.healthy ? 'passing ●' : 'FAILED ○'}`);
+                console.log(`  Reload count: ${result.reloadCount}`);
+                if (result.healthy) {
+                    console.log(`\nReady to swap: mcp-twin swap ${serverName}`);
+                }
+            }
+            else {
+                console.error(`✗ Failed: ${result.error}`);
+                process.exit(1);
+            }
+            console.log(PRAX_FOOTER);
+            break;
+        }
+        case 'swap': {
+            if (!serverName) {
+                console.log('Usage: mcp-twin swap <server-name>');
+                break;
+            }
+            const result = await manager.swapActive(serverName);
+            if (result.ok) {
+                console.log(`✓ Swapped ${serverName}`);
+                console.log(`  Previous: ${result.previousActive}`);
+                console.log(`  Now active: ${result.newActive}`);
+            }
+            else {
+                console.error(`✗ Failed: ${result.error}`);
+                if (result.hint)
+                    console.log(`  Hint: ${result.hint}`);
+                process.exit(1);
+            }
+            console.log(PRAX_FOOTER);
+            break;
+        }
+        case 'status': {
+            const result = await manager.status(serverName);
+            if (serverName && result.ok) {
+                console.log(`${serverName} Twin Status`);
+                console.log('═'.repeat(40));
+                console.log(`\nServer A (port ${result.serverA.port})`);
+                console.log(`  State: ${result.serverA.state}`);
+                console.log(`  Health: ${result.serverA.healthy ? 'healthy ●' : 'unhealthy ○'}`);
+                console.log(`  ${result.serverA.isActive ? '← ACTIVE' : '  standby'}`);
+                console.log(`\nServer B (port ${result.serverB.port})`);
+                console.log(`  State: ${result.serverB.state}`);
+                console.log(`  Health: ${result.serverB.healthy ? 'healthy ●' : 'unhealthy ○'}`);
+                console.log(`  ${result.serverB.isActive ? '← ACTIVE' : '  standby'}`);
+                console.log(`\nReloads: ${result.reloadCount}`);
+            }
+            else if (result.ok) {
+                console.log('MCP Twin Status');
+                console.log('═'.repeat(40));
+                const twins = result.twins || {};
+                if (Object.keys(twins).length === 0) {
+                    console.log('\nNo twins running.');
+                    console.log('\nAvailable servers:');
+                    (result.available || []).forEach((s) => console.log(`  - ${s}`));
+                }
+                else {
+                    for (const [name, info] of Object.entries(twins)) {
+                        const activePort = info.ports[info.active === 'a' ? 0 : 1];
+                        console.log(`\n${name}`);
+                        console.log(`  Active: ${info.active.toUpperCase()} (port ${activePort}) ${info.healthy[info.active === 'a' ? 0 : 1] ? '●' : '○'}`);
+                        console.log(`  Reloads: ${info.reloadCount}`);
+                    }
+                }
+            }
+            break;
+        }
+        case 'detect': {
+            console.log('Detecting MCP servers...');
+            const result = (0, config_detector_1.autoConfigureTwins)();
+            if (result.detected === 0) {
+                console.log('No MCP servers found.');
+                console.log('\nSearched:');
+                console.log('  - Claude Desktop: ~/Library/Application Support/Claude/');
+                console.log('  - Claude Code: ~/.claude/');
+                console.log('  - VS Code: .vscode/mcp.json');
+                console.log('  - Cursor: ~/.cursor/mcp.json');
+            }
+            else {
+                console.log(`✓ Detected ${result.detected} MCP servers:`);
+                result.servers.forEach((s) => console.log(`  - ${s}`));
+                console.log(`\n${result.configured} configured for twins.`);
+            }
+            break;
+        }
+        case 'version':
+        case '-v':
+        case '--version': {
+            console.log(`MCP Twin v${VERSION}`);
+            console.log('Powered by Prax Chat - https://prax.chat');
+            break;
+        }
+        case 'help':
+        case '-h':
+        case '--help':
+        default: {
+            console.log(`
+MCP Twin v${VERSION} - Zero-Downtime MCP Server Updates
+${'═'.repeat(50)}
+
+Works with: Claude Desktop, VS Code, Cursor, Cline, Windsurf
+
+Commands:
+  mcp-twin start <server>    Start twin servers
+  mcp-twin stop <server>     Stop twin servers (--all for all)
+  mcp-twin reload <server>   Reload standby with new code
+  mcp-twin swap <server>     Switch traffic to standby
+  mcp-twin status [server]   Show twin status
+  mcp-twin detect            Auto-detect MCP servers
+  mcp-twin help              Show this help
+
+Workflow:
+  1. mcp-twin start my-server  → Start A (active) + B (standby)
+  2. Edit your server code
+  3. mcp-twin reload my-server → Update standby B
+  4. mcp-twin swap my-server   → Switch to B (zero downtime!)
+
+Config: ~/.mcp-twin/config.json
+Logs:   ~/.mcp-twin/logs/
+${PRAX_FOOTER}
+
+Pro features: prax.chat/mcp-twin/pro
+`);
+            break;
+        }
+    }
+}
+main().catch(err => {
+    console.error('Error:', err.message);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config-detector.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Config Detector - Auto-detect MCP servers from multiple MCP clients
+ *
+ * Supports:
+ * - Claude Desktop
+ * - Claude Code
+ * - VS Code (GitHub Copilot)
+ * - Cursor
+ * - Cline
+ * - Windsurf
+ *
+ * Powered by Prax Chat - https://prax.chat
+ */
+export interface DetectedServer {
+    name: string;
+    command: string;
+    args: string[];
+    scriptPath: string | null;
+    language: 'python' | 'node' | 'unknown';
+    source: string;
+}
+/**
+ * Assign deterministic ports based on server name
+ */
+export declare function assignPorts(serverName: string): [number, number];
+/**
+ * Detect MCP servers from all supported MCP clients
+ */
+export declare function detectMCPServers(): DetectedServer[];
+/**
+ * Detect MCP servers from Claude config only (legacy)
+ */
+export declare function detectMCPServersFromClaude(): DetectedServer[];
+/**
+ * Generate twin config from detected servers
+ */
+export declare function generateTwinConfig(servers: DetectedServer[]): Record<string, any>;
+/**
+ * Auto-detect and update twin config
+ */
+export declare function autoConfigureTwins(): {
+    detected: number;
+    configured: number;
+    servers: string[];
+};
+declare const _default: {
+    detectMCPServers: typeof detectMCPServers;
+    generateTwinConfig: typeof generateTwinConfig;
+    autoConfigureTwins: typeof autoConfigureTwins;
+    assignPorts: typeof assignPorts;
+};
+export default _default;
+//# sourceMappingURL=config-detector.d.ts.map

package/dist/config-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-detector.d.ts","sourceRoot":"","sources":["../src/config-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAiBH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IACxC,MAAM,EAAE,MAAM,CAAC;CAChB;AAsID;;GAEG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAYhE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,cAAc,EAAE,CAyCnD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,cAAc,EAAE,CAkC7D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAqBjF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAShG;;;;;;;AAwBD,wBAKE"}