@anyshift/mcp-proxy 0.4.2 → 0.5.0

package/dist/index.js

@@ -18,6 +18,7 @@ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';
 import { ListToolsRequestSchema, CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import { createJqTool } from './jq/index.js';
 import { createTimeseriesTool } from './timeseries/index.js';
@@ -115,6 +116,27 @@ const CHILD_COMMAND = process.env.MCP_PROXY_CHILD_COMMAND;
 const CHILD_ARGS = process.env.MCP_PROXY_CHILD_ARGS
     ? process.env.MCP_PROXY_CHILD_ARGS.split(',').map(s => s.trim()).filter(Boolean)
     : [];
+/**
+ * MCP_PROXY_REMOTE_URL (OPTIONAL)
+ * SSE URL of a remote MCP server to connect to instead of spawning a child process
+ * When set, the proxy connects as an SSE client to the remote server
+ * Example: "http://internal-server:3100/sse"
+ */
+const REMOTE_URL = process.env.MCP_PROXY_REMOTE_URL;
+/**
+ * MCP_PROXY_REMOTE_HEADERS (OPTIONAL)
+ * JSON string of custom headers to send with SSE/POST requests to the remote server
+ * Example: '{"X-Client-Credentials":"{\"prod\":{\"AWS_ACCESS_KEY_ID\":\"AKIA...\"}}"}'
+ */
+const REMOTE_HEADERS = process.env.MCP_PROXY_REMOTE_HEADERS;
+/**
+ * MCP_PROXY_REMOTE_CREDENTIALS (OPTIONAL)
+ * JSON string of credentials to send as X-Client-Credentials header to the remote server.
+ * This is a convenience alternative to embedding credentials inside MCP_PROXY_REMOTE_HEADERS,
+ * which requires triple-escaping nested JSON.
+ * Example: '{"prod":{"AWS_ACCESS_KEY_ID":"AKIA...","AWS_SECRET_ACCESS_KEY":"..."}}'
+ */
+const REMOTE_CREDENTIALS = process.env.MCP_PROXY_REMOTE_CREDENTIALS;
 /**
  * MCP_PROXY_MAX_TOKENS (OPTIONAL, default: 10000)
  * Maximum tokens before truncating responses
@@ -191,14 +213,18 @@ const ENABLE_LOGGING = process.env.MCP_PROXY_ENABLE_LOGGING === 'true';
 // VALIDATION
 // ============================================================================
 // Validate configuration
-// CHILD_COMMAND is now optional - if not provided, proxy runs in standalone mode (JQ only)
-if (!CHILD_COMMAND) {
-    console.debug('[mcp-proxy] No child command specified - running in standalone mode (JQ only)');
+// CHILD_COMMAND and REMOTE_URL are optional - if neither provided, proxy runs in standalone mode (JQ only)
+if (!CHILD_COMMAND && !REMOTE_URL) {
+    console.debug('[mcp-proxy] No child command or remote URL specified - running in standalone mode (JQ only)');
     if (!ENABLE_JQ) {
         console.error('ERROR: Standalone mode requires JQ to be enabled (MCP_PROXY_ENABLE_JQ must not be false)');
         process.exit(1);
     }
 }
+if (CHILD_COMMAND && REMOTE_URL) {
+    console.error('ERROR: Cannot use both MCP_PROXY_CHILD_COMMAND and MCP_PROXY_REMOTE_URL');
+    process.exit(1);
+}
 if (WRITE_TO_FILE && !OUTPUT_PATH) {
     console.error('ERROR: MCP_PROXY_OUTPUT_PATH is required when MCP_PROXY_WRITE_TO_FILE=true');
     console.error('Example: export MCP_PROXY_OUTPUT_PATH="/tmp/mcp-results"');
@@ -237,8 +263,13 @@ for (const [key, value] of Object.entries(process.env)) {
 // ============================================================================
 if (ENABLE_LOGGING) {
     console.debug('[mcp-proxy] Configuration:');
-    console.debug(`  Mode: ${CHILD_COMMAND ? 'wrapper' : 'standalone (JQ only)'}`);
-    if (CHILD_COMMAND) {
+    console.debug(`  Mode: ${REMOTE_URL ? 'remote (SSE)' : CHILD_COMMAND ? 'wrapper' : 'standalone (JQ only)'}`);
+    if (REMOTE_URL) {
+        console.debug(`  Remote URL: ${REMOTE_URL}`);
+        console.debug(`  Remote headers: ${REMOTE_HEADERS ? 'configured' : 'none'}`);
+        console.debug(`  Remote credentials: ${REMOTE_CREDENTIALS ? 'configured' : 'none'}`);
+    }
+    else if (CHILD_COMMAND) {
         console.debug(`  Child command: ${CHILD_COMMAND}`);
         console.debug(`  Child args: [${CHILD_ARGS.join(', ')}]`);
     }
@@ -265,7 +296,61 @@ async function main() {
     // ------------------------------------------------------------------------
     let childClient = null;
     let childToolsResponse = { tools: [] };
-    if (CHILD_COMMAND) {
+    if (REMOTE_URL) {
+        // Remote mode: connect to a remote MCP server over SSE
+        console.debug(`[mcp-proxy] Connecting to remote MCP: ${REMOTE_URL}`);
+        let headers = {};
+        if (REMOTE_HEADERS) {
+            try {
+                headers = JSON.parse(REMOTE_HEADERS);
+            }
+            catch (e) {
+                console.error('ERROR: MCP_PROXY_REMOTE_HEADERS contains invalid JSON');
+                console.error(`  Value: ${REMOTE_HEADERS.substring(0, 100)}${REMOTE_HEADERS.length > 100 ? '...' : ''}`);
+                console.error(`  Parse error: ${e instanceof Error ? e.message : String(e)}`);
+                process.exit(1);
+            }
+        }
+        if (REMOTE_CREDENTIALS) {
+            try {
+                JSON.parse(REMOTE_CREDENTIALS); // Validate JSON before sending
+            }
+            catch (e) {
+                console.error('ERROR: MCP_PROXY_REMOTE_CREDENTIALS contains invalid JSON');
+                console.error(`  Value: ${REMOTE_CREDENTIALS.substring(0, 100)}${REMOTE_CREDENTIALS.length > 100 ? '...' : ''}`);
+                console.error(`  Parse error: ${e instanceof Error ? e.message : String(e)}`);
+                process.exit(1);
+            }
+            headers['X-Client-Credentials'] = REMOTE_CREDENTIALS;
+        }
+        const childTransport = new SSEClientTransport(new URL(REMOTE_URL), {
+            eventSourceInit: {
+                fetch: (url, init) => {
+                    // Safely convert init.headers (could be Headers object, array, or plain object)
+                    const initHeaders = init?.headers
+                        ? Object.fromEntries(new Headers(init.headers))
+                        : {};
+                    return fetch(url, {
+                        ...init,
+                        headers: { ...initHeaders, ...headers },
+                    });
+                },
+            },
+            requestInit: { headers },
+        });
+        childClient = new Client({
+            name: 'mcp-proxy-client',
+            version: '1.0.0'
+        }, {
+            capabilities: {}
+        });
+        await childClient.connect(childTransport);
+        console.debug('[mcp-proxy] Connected to remote MCP');
+        // Discover tools from remote MCP
+        childToolsResponse = await childClient.listTools();
+        console.debug(`[mcp-proxy] Discovered ${childToolsResponse.tools.length} tools from remote MCP`);
+    }
+    else if (CHILD_COMMAND) {
         console.debug(`[mcp-proxy] Spawning child MCP: ${CHILD_COMMAND}`);
         const childTransport = new StdioClientTransport({
             command: CHILD_COMMAND,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anyshift/mcp-proxy",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "description": "Generic MCP proxy that adds truncation, file writing, and JQ capabilities to any MCP server",
   "type": "module",
   "main": "dist/index.js",