@deotio/mcp-sigv4-proxy 0.2.1 → 0.3.0

package/README.md

@@ -14,12 +14,13 @@ Add to your `.mcp.json`:
   "args": ["-y", "@deotio/mcp-sigv4-proxy"],
   "env": {
     "AWS_PROFILE": "dot-finops",
+    "AWS_REGION": "us-east-1",
     "MCP_SERVER_URL": "https://bedrock-agentcore.us-east-1.amazonaws.com/runtimes/.../invocations?qualifier=DEFAULT"
   }
 }
 ```
 
-The service name (`bedrock-agentcore`) and region (`us-east-1`) are inferred from the URL automatically. Set `AWS_REGION` and `AWS_SERVICE` only when using non-standard endpoints.
+Always set `AWS_REGION` explicitly — the proxy can infer it from standard AWS hostnames, but `AWS_REGION` from your shell environment takes precedence and may point to a different region. `AWS_SERVICE` is inferred automatically and only needs to be set for non-standard endpoints.
 
 ## How it works
 

package/dist/proxy.js

@@ -5,8 +5,9 @@ import { Sha256 } from '@aws-crypto/sha256-js';
 import readline from 'readline';
 export const MAX_SSE_BUFFER_BYTES = 1_048_576; // 1 MB
 const DEFAULT_TIMEOUT_MS = 180_000; // 180s, matches AWS proxy
-const DEFAULT_RETRIES = 0;
+const DEFAULT_RETRIES = 2;
 const RETRY_BASE_MS = 1000;
+const COLD_START_RETRY_MS = 5000;
 const LOG_LEVEL_ORDER = {
     DEBUG: 0,
     INFO: 1,
@@ -145,10 +146,14 @@ async function fetchWithRetry(url, init, timeoutMs, retries) {
     for (let attempt = 0; attempt <= retries; attempt++) {
         try {
             const response = await fetchWithTimeout(url, init, timeoutMs);
-            // Only retry on 5xx server errors
-            if (response.status >= 500 && attempt < retries) {
-                log('WARNING', `HTTP ${response.status}, retrying (${attempt + 1}/${retries})`);
-                await sleep(RETRY_BASE_MS * Math.pow(2, attempt));
+            // Retry on 5xx server errors and 424 (AgentCore cold-start timeout)
+            const retryable = response.status >= 500 || response.status === 424;
+            if (retryable && attempt < retries) {
+                const delay = response.status === 424
+                    ? COLD_START_RETRY_MS * Math.pow(2, attempt)
+                    : RETRY_BASE_MS * Math.pow(2, attempt);
+                log('WARNING', `HTTP ${response.status}, retrying in ${delay}ms (${attempt + 1}/${retries})`);
+                await sleep(delay);
                 continue;
             }
             return response;
@@ -172,10 +177,22 @@ export async function handleResponse(response, requestId) {
     if (!response.ok) {
         const text = await response.text();
         log('ERROR', `HTTP ${response.status}: ${text}`);
+        // Extract the upstream message for the JSON-RPC error (if JSON, use .message; otherwise trim)
+        let detail = '';
+        try {
+            const parsed = JSON.parse(text);
+            if (typeof parsed.message === 'string')
+                detail = `: ${parsed.message}`;
+        }
+        catch {
+            const trimmed = text.trim();
+            if (trimmed.length > 0 && trimmed.length <= 200)
+                detail = `: ${trimmed}`;
+        }
         process.stdout.write(JSON.stringify({
             jsonrpc: '2.0',
             id: requestId,
-            error: { code: -32000, message: `HTTP ${response.status}` },
+            error: { code: -32000, message: `HTTP ${response.status}${detail}` },
         }) + '\n');
         return;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deotio/mcp-sigv4-proxy",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "stdio MCP proxy with AWS SigV4 signing — connect Claude Code to any IAM-authenticated MCP server using a named AWS profile",
   "type": "module",
   "bin": {