@phidiassj/aiyoperps-mcp-bridge 0.8.1

package/README.md

@@ -0,0 +1,39 @@
+# AiyoPerps MCP Bridge
+
+This package exposes a standard MCP `stdio` server that forwards requests to the local AiyoPerps HTTP MCP endpoint.
+
+## Usage
+
+```bash
+npx -y @phidiassj/aiyoperps-mcp-bridge
+```
+
+Custom endpoint:
+
+```bash
+npx -y @phidiassj/aiyoperps-mcp-bridge --url http://127.0.0.1:5078/mcp
+```
+
+Or via environment variable:
+
+```bash
+AIYOPERPS_MCP_URL=http://127.0.0.1:5078/mcp npx -y @phidiassj/aiyoperps-mcp-bridge
+```
+
+## Typical MCP config
+
+```json
+{
+  "mcpServers": {
+    "aiyoperps": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@phidiassj/aiyoperps-mcp-bridge",
+        "--url",
+        "http://127.0.0.1:5078/mcp"
+      ]
+    }
+  }
+}
+```

package/bin/aiyoperps-mcp-bridge.js

@@ -0,0 +1,141 @@
+#!/usr/bin/env node
+'use strict';
+
+const { stdin, stdout, stderr, exit, argv, env } = require('node:process');
+
+const endpoint = resolveEndpoint(argv.slice(2));
+let buffer = Buffer.alloc(0);
+let expectedBodyLength = null;
+
+stderr.write(`[aiyoperps-mcp-bridge] forwarding stdio MCP to ${endpoint}\n`);
+
+stdin.on('data', chunk => {
+  buffer = Buffer.concat([buffer, chunk]);
+  tryProcessBuffer();
+});
+
+stdin.on('end', () => {
+  stderr.write('[aiyoperps-mcp-bridge] stdin closed\n');
+  exit(0);
+});
+
+stdin.on('error', error => {
+  stderr.write(`[aiyoperps-mcp-bridge] stdin error: ${error.message}\n`);
+  exit(1);
+});
+
+function tryProcessBuffer() {
+  while (true) {
+    if (expectedBodyLength === null) {
+      const headerEndIndex = buffer.indexOf('\r\n\r\n');
+      if (headerEndIndex === -1) {
+        return;
+      }
+
+      const headerText = buffer.subarray(0, headerEndIndex).toString('utf8');
+      const lengthMatch = /content-length:\s*(\d+)/i.exec(headerText);
+      if (!lengthMatch) {
+        stderr.write('[aiyoperps-mcp-bridge] invalid MCP frame: missing Content-Length\n');
+        exit(1);
+      }
+
+      expectedBodyLength = Number.parseInt(lengthMatch[1], 10);
+      buffer = buffer.subarray(headerEndIndex + 4);
+    }
+
+    if (buffer.length < expectedBodyLength) {
+      return;
+    }
+
+    const body = buffer.subarray(0, expectedBodyLength);
+    buffer = buffer.subarray(expectedBodyLength);
+    expectedBodyLength = null;
+
+    handleMessage(body).catch(error => {
+      stderr.write(`[aiyoperps-mcp-bridge] message handling failed: ${error.stack || error.message}\n`);
+      exit(1);
+    });
+  }
+}
+
+async function handleMessage(bodyBuffer) {
+  const bodyText = bodyBuffer.toString('utf8');
+  let payload;
+
+  try {
+    payload = JSON.parse(bodyText);
+  } catch (error) {
+    stderr.write(`[aiyoperps-mcp-bridge] invalid JSON from client: ${error.message}\n`);
+    writeFrame(JSON.stringify({
+      jsonrpc: '2.0',
+      error: {
+        code: -32700,
+        message: 'Invalid JSON received by bridge.'
+      },
+      id: null
+    }));
+    return;
+  }
+
+  let response;
+  try {
+    response = await postJson(endpoint, payload);
+  } catch (error) {
+    stderr.write(`[aiyoperps-mcp-bridge] upstream request failed: ${error.message}\n`);
+    writeFrame(JSON.stringify({
+      jsonrpc: '2.0',
+      error: {
+        code: -32000,
+        message: `AiyoPerps MCP endpoint unavailable: ${error.message}`
+      },
+      id: payload && typeof payload === 'object' && 'id' in payload ? payload.id : null
+    }));
+    return;
+  }
+
+  writeFrame(JSON.stringify(response));
+}
+
+async function postJson(url, payload) {
+  const response = await fetch(url, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json'
+    },
+    body: JSON.stringify(payload)
+  });
+
+  const text = await response.text();
+  if (!response.ok) {
+    throw new Error(`HTTP ${response.status}: ${text || response.statusText}`);
+  }
+
+  try {
+    return JSON.parse(text);
+  } catch (error) {
+    throw new Error(`Invalid JSON from AiyoPerps MCP endpoint: ${error.message}`);
+  }
+}
+
+function writeFrame(jsonText) {
+  const body = Buffer.from(jsonText, 'utf8');
+  const header = Buffer.from(`Content-Length: ${body.length}\r\n\r\n`, 'utf8');
+  stdout.write(Buffer.concat([header, body]));
+}
+
+function resolveEndpoint(args) {
+  const fallback = env.AIYOPERPS_MCP_URL || 'http://127.0.0.1:5078/mcp';
+
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (arg.startsWith('--url=')) {
+      return arg.slice('--url='.length);
+    }
+
+    if (arg === '--url' && index + 1 < args.length) {
+      return args[index + 1];
+    }
+  }
+
+  return fallback;
+}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@phidiassj/aiyoperps-mcp-bridge",
+  "version": "0.8.1",
+  "description": "Stdio MCP bridge for the AiyoPerps local HTTP MCP endpoint.",
+  "license": "MIT",
+  "bin": {
+    "aiyoperps-mcp-bridge": "./bin/aiyoperps-mcp-bridge.js"
+  },
+  "type": "commonjs",
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "bin"
+  ],
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "aiyoperps",
+    "bridge",
+    "stdio"
+  ]
+}