MarsNMe MCP Gateway (io.github.Marsmanleo/marsnme)

io.github.Marsmanleo/marsnme is an agent-agnostic memory backend that preserves continuity between humans and AI over time. It provides an MCP server that serves memory tools over a streamable HTTP transport. It also exposes a health endpoint for operational checks.

Key Features

MCP server endpoint at POST /mcp
Health status endpoint at GET /health
Streamable HTTP transport for memory tools
Embedding-based memory search via a Jina API key

🚀 Use Cases

Persisting and retrieving memory for AI agents over time
Maintaining continuity between human interactions and AI outputs
Semantic search over stored memory using embeddings

⚡ Developer Benefits

Requires Node.js >=20
Integrates with Supabase for storage (schema migrations required)
Supports embedding-based search using Jina API credentials

⚠️ Limitations

Needs a Supabase project with required schema migrations applied
Requires a Jina API key for embedding-based memory search

Required environment variables

MCP_PROFILE

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

Service role key used for database operations

JINA_API_KEY

Required for semantic search / embedding features

Common optional environment variables

PORT

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

OAuth endpoints are enabled by default (set false to disable)

MCP_CLIENT_ID and MCP_CLIENT_SECRET

Optional static OAuth client credentials

Deployment safety gate (before restart)

For upgrades, run database migrations with an explicit DDL-capable role and gate schema compatibility before restarting services.

Recommended role guidance:

Use a role that can execute DDL on target schemas.

On Supabase-hosted Postgres this is typically supabase_admin (not postgres).

Schema gate command:

bash

bash deploy/phase2/pre_deploy_schema_gate.sh \
  --db-url "<postgres://supabase_admin:<password>@<host>:5432/postgres>" \
  --profiles coco,toto \
  --expected-role supabase_admin

If gate exits non-zero, stop deployment and do not restart services.

Install

Configuration

Environment variables

MCP_PROFILErequired

Profile ID used to separate memory data (for example: profile-a).

SUPABASE_BASE_URLrequired

Supabase REST API project URL.

SUPABASE_SERVICE_ROLE_KEYrequiredsecret

Supabase service role key.

JINA_API_KEYrequiredsecret

Jina AI API key for embedding-based tools.

PORT

Local HTTP port for the MCP endpoint. If omitted, defaults by MCP_PROFILE (coco=18790, toto=18791, others deterministic in 20000-29999).

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "marsnme": {
      "command": "npx",
      "args": [
        "-y",
        "@marsnme/mcp-gateway@0.3.0"
      ],
      "env": {
        "MCP_PROFILE": "<YOUR_MCP_PROFILE>",
        "SUPABASE_BASE_URL": "<YOUR_SUPABASE_BASE_URL>",
        "SUPABASE_SERVICE_ROLE_KEY": "<YOUR_SUPABASE_SERVICE_ROLE_KEY>",
        "JINA_API_KEY": "<YOUR_JINA_API_KEY>",
        "PORT": "<YOUR_PORT>"
      }
    }
  }
}

MarsNMe

MarsNMe MCP Gateway (io.github.Marsmanleo/marsnme)

Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

@marsnme/mcp-gateway

Requirements

Quick start (npx)

Required environment variables

Common optional environment variables

Minimal validation

Deployment safety gate (before restart)

Database setup and full onboarding

Install

Configuration

Related servers