@apogea/apports-mcp 1.0.0

package/README.md

@@ -0,0 +1,20 @@
+# @apports/mcp-cli
+
+Puente de línea de comandos para conectar clientes MCP locales (Claude Desktop) con el servidor backend de Apports.
+
+## Uso con npx
+
+```json
+{
+  "mcpServers": {
+    "apports": {
+      "command": "npx",
+      "args": ["-y", "@apports/mcp-cli"],
+      "env": {
+        "APPORTS_URL": "[https://appports.ports.gencat.cat/mcp](https://appports.ports.gencat.cat/mcp)",
+        "APPORTS_TOKEN": "tu_token_pat_aqui"
+      }
+    }
+  }
+}
+```

package/bin/cli.js

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+
+const axios = require("axios");
+const readline = require("readline");
+
+const API_URL = process.env.APPORTS_URL || "http://localhost:3000/mcp";
+const AUTH_TOKEN = process.env.APPORTS_TOKEN || "";
+
+if (!AUTH_TOKEN) {
+  console.error("[Apports MCP] Error: APPORTS_TOKEN no configurado.");
+  process.exit(1);
+}
+
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout,
+  terminal: false,
+});
+
+function emitJsonRpc(rawData) {
+  if (!rawData) return;
+
+  if (typeof rawData === "object") {
+    console.log(JSON.stringify(rawData));
+    return;
+  }
+
+  if (typeof rawData === "string") {
+    const lines = rawData.split("\n");
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (trimmed.startsWith("data:")) {
+        const jsonContent = trimmed.replace(/^data:\s*/, "").trim();
+        if (jsonContent) {
+          try {
+            console.log(JSON.stringify(JSON.parse(jsonContent)));
+          } catch (e) {
+            console.error("[Apports MCP] Error parseando SSE:", jsonContent);
+          }
+        }
+      } else if (trimmed.startsWith("{") && trimmed.endsWith("}")) {
+        try {
+          console.log(JSON.stringify(JSON.parse(trimmed)));
+        } catch (e) {
+          // Ignorar no-JSON
+        }
+      }
+    }
+  }
+}
+
+rl.on("line", async (line) => {
+  if (!line.trim()) return;
+
+  let payload;
+  try {
+    payload = JSON.parse(line);
+  } catch {
+    return;
+  }
+
+  try {
+    const response = await axios.post(API_URL, payload, {
+      headers: {
+        Authorization: `Bearer ${AUTH_TOKEN}`,
+        "Content-Type": "application/json",
+        Accept: "application/json, text/event-stream",
+      },
+      responseType: "text",
+    });
+
+    emitJsonRpc(response.data);
+  } catch (error) {
+    const status = error.response?.status;
+    const responseData = error.response?.data;
+
+    console.error(
+      `[Apports MCP Error ${status || "HTTP"}]`,
+      responseData || error.message,
+    );
+
+    // 🔑 Si es una notificación (no tiene id), NO enviamos respuesta por STDOUT
+    if (payload?.id === undefined || payload?.id === null) {
+      return;
+    }
+
+    let errorMessage = error.message;
+    if (typeof responseData === "object" && responseData?.message) {
+      errorMessage = responseData.message;
+    } else if (typeof responseData === "string") {
+      errorMessage = responseData;
+    }
+
+    const jsonRpcError = {
+      jsonrpc: "2.0",
+      id: payload.id,
+      error: {
+        code: status === 401 ? -32001 : -32603,
+        message: `[HTTP ${status || "Error"}] ${errorMessage}`,
+      },
+    };
+
+    console.log(JSON.stringify(jsonRpcError));
+  }
+});

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@apogea/apports-mcp",
+  "version": "1.0.0",
+  "description": "Puente CLI de STDIO a HTTP Streamable para el servidor MCP de Apports",
+  "main": "bin/cli.js",
+  "bin": {
+    "apports-mcp-cli": "./bin/cli.js"
+  },
+  "scripts": {
+    "start": "node bin/cli.js"
+  },
+  "dependencies": {
+    "axios": "^1.7.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude-desktop",
+    "apports",
+    "copilot"
+  ],
+  "author": "Apogea",
+  "license": "MIT"
+}