MarsNMe

本地服务

marsnme.com记忆与知识71 周前更新

代码仓库访问官网

关于 MarsNMe

MarsNMe 是面向 Agent 的记忆后端，通过 MCP Gateway 提供记忆工具，帮助在人与 AI 之间延续长期上下文。它依赖 Supabase 存储，并使用 Jina 支持语义搜索。

主要功能

01通过流式 HTTP 提供 MCP
02使用 Supabase 处理记忆数据
03支持嵌入式语义搜索
04提供健康状态端点

适用场景

01为 AI Agent 保留跨会话记忆
02按语义检索已存储的记忆

MCP 相关

该网关在 `/mcp` 提供 MCP 服务端点，并通过流式 HTTP 暴露记忆工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "marsmanleo-marsnme": {
      "command": "npx",
      "args": [
        "-y",
        "@marsnme/mcp-gateway"
      ],
      "env": {
        "MCP_PROFILE": "<MCP_PROFILE>",
        "SUPABASE_BASE_URL": "<SUPABASE_BASE_URL>",
        "SUPABASE_SERVICE_ROLE_KEY": "<SUPABASE_SERVICE_ROLE_KEY>",
        "JINA_API_KEY": "<JINA_API_KEY>",
        "PORT": "<PORT>"
      }
    }
  }
}

启动命令npx -y @marsnme/mcp-gateway

需要配置的环境变量

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

SUPABASE_BASE_URLSupabase REST API project URL.

SUPABASE_SERVICE_ROLE_KEY密钥Supabase service role key.

JINA_API_KEY密钥Jina AI API key for embedding-based tools.

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

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@marsnme/mcp-gateway0.3.2Streamable HTTP

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

@marsnme/mcp-gateway

MarsNMe 演示

MarsNMe MCP 网关，用于通过可流式 HTTP 传输提供记忆工具。

此软件包会在 POST /mcp 运行 MCP 服务，并在 GET /health 提供健康状态。

要求

Node.js >=20
已应用所需架构迁移的 Supabase 项目
用于基于嵌入的记忆搜索的 Jina API 密钥

快速开始（npx）

MCP_PROFILE=coco \
SUPABASE_BASE_URL=https://<your-project-ref>.supabase.co \
SUPABASE_SERVICE_ROLE_KEY=<your-service-role-key> \
JINA_API_KEY=<your-jina-api-key> \
npx -y @marsnme/mcp-gateway

启动后：

健康状态：http://127.0.0.1:18790/health
MCP 端点：http://127.0.0.1:18790/mcp

必需的环境变量

MCP_PROFILE
- 符合 ^[a-z][a-z0-9_-]*$ 的任意小写配置 ID（例如：coco、toto、my-agent）
- 旧版内置 ID：coco 和 toto
SUPABASE_BASE_URL
- Supabase REST 项目 URL
SUPABASE_SERVICE_ROLE_KEY（推荐）或 SUPABASE_SERVICE_KEY
- 用于数据库操作的服务角色密钥
JINA_API_KEY
- 语义搜索／嵌入功能所必需

常见的可选环境变量

PORT
- 覆盖网关使用的 HTTP 端口
- 如果省略，网关会根据配置解析默认端口：
  - coco → 18790
  - toto → 18791
  - 其他配置 ID → 在 20000-29999 范围内确定性分配的端口
MCP_REQUIRE_BEARER
- 设置为 true，要求 MCP 调用携带 Authorization: Bearer <token>
MCP_OAUTH_ENABLED
- 默认启用 OAuth 端点（设置为 false 可禁用）
MCP_CLIENT_ID 和 MCP_CLIENT_SECRET
- 可选的静态 OAuth 客户端凭据

最低限度验证

检查服务健康状态：

curl -sS http://127.0.0.1:18790/health

列出工具：

curl -sS http://127.0.0.1:18790/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

部署安全门（重启前）

升级时，使用明确具备 DDL 权限的角色运行数据库迁移，并在重启服务前检查架构兼容性。

推荐的角色指南：

使用能够在目标架构上执行 DDL 的角色。
对于托管在 Supabase 上的 Postgres，通常应使用 supabase_admin（而不是 postgres）。

架构检查命令：

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