@marsnme/mcp-gateway 0.1.5 → 0.1.7

package/README.md

@@ -1,4 +1,9 @@
 # @marsnme/mcp-gateway
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Marsmanleo/MarsNMe/main/docs/assets/demo.gif" alt="MarsNMe demo" width="640" />
+</p>
+
 MarsNMe MCP Gateway for memory tools over streamable HTTP transport.
 
 This package runs an MCP server at `POST /mcp` and exposes health status at `GET /health`.
@@ -23,8 +28,8 @@ After startup:
 
 ## Required environment variables
 - `MCP_PROFILE`
-  - Supported values: `coco` or `toto`
-  - Default: `coco`
+  - Any lowercase profile ID matching `^[a-z][a-z0-9_-]*$` (for example: `coco`, `toto`, `my-agent`)
+  - Legacy built-in IDs: `coco` and `toto`
 - `SUPABASE_BASE_URL`
   - Your Supabase REST project URL
 - `SUPABASE_SERVICE_ROLE_KEY` (recommended) or `SUPABASE_SERVICE_KEY`
@@ -34,7 +39,11 @@ After startup:
 
 ## Common optional environment variables
 - `PORT`
-  - Overrides default port (`18790` for `coco`, `18791` for `toto`)
+  - Overrides the HTTP port used by the gateway
+  - If omitted, the gateway resolves a profile-based default:
+    - `coco` → `18790`
+    - `toto` → `18791`
+    - other profile IDs → deterministic port in `20000-29999`
 - `MCP_REQUIRE_BEARER`
   - Set `true` to require `Authorization: Bearer <token>` on MCP calls
 - `MCP_OAUTH_ENABLED`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marsnme/mcp-gateway",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "mcpName": "io.github.Marsmanleo/marsnme",
   "private": false,
   "description": "Agent-agnostic, LLM-agnostic memory backend for MCP-compatible tools",
@@ -14,10 +14,19 @@
   "keywords": [
     "mcp",
     "memory",
-    "ai",
-    "symbiosis",
+    "ai-memory",
+    "persistent-memory",
+    "ai-agent",
+    "model-context-protocol",
+    "semantic-search",
+    "supabase",
+    "jina",
     "embedding",
-    "supabase"
+    "typescript",
+    "session-memory",
+    "cross-session",
+    "llm",
+    "symbiosis"
   ],
   "bin": {
     "marsnme": "server.mjs"

package/server.mjs

@@ -45,6 +45,19 @@ const PROFILE_CONFIGS = {
     memoryIngestFixedTags: ['toto', 'insight']
   }
 };
+const PROFILE_DEFAULT_PORT_RANGE_START = 20000;
+const PROFILE_DEFAULT_PORT_RANGE_SIZE = 10000;
+const PROFILE_LEGACY_DEFAULT_PORTS = {
+  coco: 18790,
+  toto: 18791
+};
+function resolveProfileDefaultPort(profileId) {
+  const legacyPort = PROFILE_LEGACY_DEFAULT_PORTS[profileId];
+  if (Number.isInteger(legacyPort)) return legacyPort;
+  const hash = crypto.createHash('sha256').update(profileId).digest();
+  const slot = hash.readUInt16BE(0) % PROFILE_DEFAULT_PORT_RANGE_SIZE;
+  return PROFILE_DEFAULT_PORT_RANGE_START + slot;
+}
 const PROFILE_ID_PATTERN = /^[a-z][a-z0-9_-]*$/;
 function buildProfileConfig(profileId) {
   const legacyProfile = PROFILE_CONFIGS[profileId];
@@ -53,7 +66,7 @@ function buildProfileConfig(profileId) {
     ...PROFILE_CONFIGS.coco,
     schema: profileId,
     displayName: profileId,
-    defaultPort: 18790,
+    defaultPort: resolveProfileDefaultPort(profileId),
     gatewayDir: `${profileId}-mcp-gateway`,
     publicHostSuffix: `${profileId}-mcp.marsgroup.asia`,
     recallBodyEnum: [profileId, 'system'],
@@ -151,7 +164,12 @@ function setMemorySourceWhitelist(nextSources) {
 }
 setMemorySourceWhitelist(buildMemorySourceListForMode());
 
-const PORT = Number.parseInt(process.env.PORT || '18790', 10);
+const PORT_RAW = String(process.env.PORT || '').trim();
+const PORT_SOURCE = PORT_RAW ? 'env' : 'profile-default';
+const PORT = Number.parseInt(PORT_RAW || String(PROFILE.defaultPort), 10);
+if (!Number.isInteger(PORT) || PORT < 1 || PORT > 65535) {
+  throw new Error(`Invalid PORT: ${PORT_RAW || String(PORT)}. Must be an integer between 1 and 65535.`);
+}
 const SUPABASE_BASE_URL = process.env.SUPABASE_BASE_URL || 'http://127.0.0.1:8100';
 const OAUTH_ENABLED = process.env.MCP_OAUTH_ENABLED !== 'false';
 const REQUIRE_BEARER = process.env.MCP_REQUIRE_BEARER === 'true';
@@ -4336,8 +4354,27 @@ const server = http.createServer(async (req, res) => {
   }
 });
 
+server.on('error', (error) => {
+  if (error?.code === 'EADDRINUSE') {
+    const hint =
+      PORT_SOURCE === 'env'
+        ? `Set PORT to an unused value (current PORT=${PORT}).`
+        : `Set PORT to an unused value or use another MCP_PROFILE (profile=${MCP_PROFILE}, default_port=${PROFILE.defaultPort}).`;
+    console.error(`[fatal] ${SERVER_NAME} cannot start: port ${PORT} is already in use. ${hint}`);
+    process.exit(1);
+    return;
+  }
+  console.error(
+    `[fatal] ${SERVER_NAME} failed to start: ${String(error?.message || error)}`
+  );
+  process.exit(1);
+});
+
 server.listen(PORT, '0.0.0.0', () => {
   console.log(`${SERVER_NAME} listening on 0.0.0.0:${PORT}`);
+  console.log(
+    `[config] profile=${MCP_PROFILE} resolved_port=${PORT} source=${PORT_SOURCE} profile_default_port=${PROFILE.defaultPort}`
+  );
   console.log(`[config] source_mode=${SOURCE_MODE}`);
   if (SOURCE_MODE === 'registry') {
     void reloadSourceRegistryCache()