@anyshift/mcp-proxy 0.4.2-dev0 → 0.5.0

package/dist/fileWriter/writer.js

@@ -5,18 +5,10 @@ import { generateQueryAssistSchema, generateJsonlQueryAssistSchema } from './sch
 import { parseDynatraceDqlResponse, isDynatraceDqlTool, } from './dynatrace.js';
 // Default minimum character count to trigger file writing
 const DEFAULT_MIN_CHARS = 1000;
-/**
- * Generate the message to include when data is written to file, guiding the LLM on how to use the result.
- * The message conditionally includes the timeseries tool based on configuration.
- */
-function getFileWrittenMessage(enableTimeseries) {
-    const toolsList = enableTimeseries
-        ? '"execute_jq_query" tool (for JSON/JSONL data extraction and transformation) or "detect_timeseries_anomalies" tool (for time series analysis)'
-        : '"execute_jq_query" tool (for JSON/JSONL data extraction and transformation)';
-    return `To read this file, use the ${toolsList}.
+// Message to include when data is written to file, guiding the LLM on how to use the result
+const FILE_WRITTEN_MESSAGE = `To read this file, use the "execute_jq_query" tool (for JSON/JSONL data extraction and transformation) or "detect_timeseries_anomalies" tool (for time series analysis, if available).
 
 IMPORTANT for supporting facts: This tool_id CANNOT be used as the proxy_tool_id in your output's supporting_facts evidence. You must read the file using one of the tools above and use THAT tool's tool_id as the proxy_tool_id to support facts in your output.`;
-}
 /**
  * Detect whether content is JSON, JSONL, or plain text
  */
@@ -263,7 +255,7 @@ async function handleDynatraceDqlResponse(config, tool_id, parsedDql) {
             wroteToFile: true,
             filePath: filepath,
             fileSchema,
-            message: getFileWrittenMessage(config.enableTimeseries ?? false),
+            message: FILE_WRITTEN_MESSAGE,
         };
     }
     catch (error) {
@@ -401,7 +393,7 @@ export async function handleToolResponse(config, toolName, args, responseData) {
             wroteToFile: true,
             filePath: filepath,
             fileSchema,
-            message: getFileWrittenMessage(config.enableTimeseries ?? false),
+            message: FILE_WRITTEN_MESSAGE,
         };
     }
     catch (error) {

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,
@@ -324,8 +409,7 @@ async function main() {
         toolAbbreviations: {}, // No service-specific abbreviations (generic proxy)
         schemaMaxDepth: SCHEMA_MAX_DEPTH,
         schemaMaxPaths: SCHEMA_MAX_PATHS,
-        schemaMaxKeys: SCHEMA_MAX_KEYS,
-        enableTimeseries: ENABLE_TIMESERIES
+        schemaMaxKeys: SCHEMA_MAX_KEYS
     };
     const fileWriter = createFileWriter(fileWriterConfig);
     // JQ tool configuration

package/dist/types/index.d.ts

@@ -34,8 +34,6 @@ export interface FileWriterConfig {
     schemaMaxPaths?: number;
     /** Maximum keys to analyze per object (default: 50) */
     schemaMaxKeys?: number;
-    /** Whether the timeseries anomaly detection tool is enabled (affects file-written message) */
-    enableTimeseries?: boolean;
 }
 /**
  * Configuration for the JQ tool

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anyshift/mcp-proxy",
-  "version": "0.4.2-dev0",
+  "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",