Memxus

Memxus — 上下文工程

一个上下文层。适用于所有 AI。

为每个 AI 提供恰当的上下文，提升你的工作效率。

Memxus 将上下文工程融入你的整个 AI 工作流。

只需保存一次真实的决策、偏好和工作上下文。几秒内即可找到，并将每项任务所需的确切上下文提供给 Claude、Cursor、ChatGPT、Gemini 或任何 MCP 客户端。

无需反复解释。无需从零开始。更快获得更好的答案。

Glama MCP 服务 许可证：AGPL-3.0 Node 20+ Railway MCP 注册表 v1.2.1

网站 · 文档 · 连接你的第一个 AI

---

在 YouTube 上观看 Memxus 演示

▶️ 在 YouTube 上观看演示 · 演示页面

---

---

问题所在

AI 工具功能强大，但如果缺少恰当的上下文，工作效率就会下降。

Claude 不知道 Cursor 掌握的信息。Cursor 不知道 ChatGPT 掌握的信息。你在项目中的决策、偏好、架构和工作流上下文，会在每个工具和每次新对话中反复重述。

这会带来不必要的工作：

• 反复解释相同的信息
• 在代码库、文档和对话中搜索
• 根据缺失的上下文纠正答案
• 重复说明技术和产品决策
• 每次 AI 任务都从零开始

Memxus 通过上下文工程解决这个问题。

只需保存一次重要信息，几秒内即可找到，并将每项任务所需的确切上下文提供给每个 AI。

这样，你就能在整个 AI 工作流中减少重复和来回沟通，加快执行速度，并获得更好的答案。

在 Claude 中保存一项决策 → 在 Cursor 中调用 → 在 ChatGPT 中复用。
需要更深入的上下文？准备好后，随时连接 GitHub 和 Notion。

---

什么是 Memxus？

Memxus 是一款上下文工程工具，旨在通过为每个 AI 提供恰当的上下文来提升你的工作效率。

它在 Claude、Cursor、ChatGPT、Gemini 和任何兼容 MCP 的客户端之间创建共享的上下文层。

核心工作流很简单：

• remember 重要信息
• 从任何 AI 中 recall 这些信息
• 几秒内找到相关上下文
• 向每个 AI 提供它生成更好答案所需的信息

通过 OAuth 连接一次，你的决策、偏好和工作上下文便可在整个 AI 工作流中随时使用，无需本地设置、反复解释，也无需在工具之间复制粘贴。

为了提供更深入的上下文，Memxus 还可以连接 GitHub 和 Notion 等实际工作数据源。代码库、文档、提交、拉取请求、问题以及选定的工作区页面，都可以与手动保存的上下文一起搜索。

GitHub 和 Notion 连接器已在生产环境中上线。此类深度同步为可选功能：从保存第一项决策起，Memxus 就能发挥作用。

保存一次。快速查找。为每个 AI 提供恰当的上下文。更快地完成工作。

开发者为何使用 Memxus

• 保存一次，在所有 AI 中随时回忆 — 不必再在 Claude、Cursor 和 ChatGPT 中反复说明你的技术栈、决策和偏好
• 询问一次 — 不必再翻遍 5 个工具，只为想起你选择 X 的原因
• 在 Claude、Cursor 和 ChatGPT 中随时获取项目架构和技术栈背景信息
• 将 GitHub 和 Notion 同步到统一的项目集合中 — 每个仓库对应一个上下文
• 不必再把相同的上下文粘贴到每个新的 AI 会话中
• 在不同 Agent 和工作流之间共享团队上下文
• 通过 MCP 或 API，使用持久化上下文构建 AI 应用

---

来自 GitHub 和 Notion 的真实上下文

Memxus 读取的是你的真实工作内容，而非通用的记忆片段。同步的内容会归入每个项目的统一集合：project:<slug>。

同步内容

来源	编入上下文的内容
GitHub	仓库、README、提交、拉取请求、问题
Notion	选定的工作区页面和文档
手动	通过 remember 保存的决策、偏好和笔记

连接方式

1. 控制面板 — dashboard.memxus.com/integrations（GitHub App + Notion OAuth）
2. 通过聊天（MCP） — connect_source → check_connect_status → list_syncable_items → set_sync_selection

如何使用同步的上下文

调用 recall 或 get_context，并设置 collection=project:<slug>（也可以让语义搜索自动查找）。GitHub/Notion 内容会添加标签，并可与手动保存的记忆一起搜索。

flowchart LR
  Save["💾 Save — from any AI"] --> Memxus["🧠 Memxus — your persistent memory"] --> Recall["✨ Recall anywhere — Claude · Cursor · ChatGPT · Gemini"]

用一条消息开始保存

将 Memxus 连接到任意 AI 后，粘贴类似下面这样的一行 — Memxus 会调用 remember，让你的上下文随处可用：

Remember this in Memxus: we use Postgres + pgvector for semantic search.

开始使用不需要同步 GitHub/Notion。想要更深入的项目上下文时再进行同步。

可选 — 同步你的整个技术栈： GitHub 仓库、Notion 页面、文件、文档和决策也都可以成为可回忆的上下文。

Context Engine 连接器工具（4 个）： 通过 MCP 在聊天中连接 GitHub/Notion。生产环境提供 9 个核心工具；4 个连接器工具按账户启用，因此新连接的客户端会看到核心 9 个工具。

---

一秒连接，一键完成

URL:       https://mcp.memxus.com/mcp
Auth:      OAuth 2.1 (handled automatically)
Transport: Streamable HTTP

Claude Desktop（claude_desktop_config.json）

{
  "mcpServers": {
    "memxus": {
      "url": "https://mcp.memxus.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Cursor / VS Code

{
  "mcp": {
    "servers": {
      "memxus": {
        "url": "https://mcp.memxus.com/mcp",
        "transport": "http"
      }
    }
  }
}

或者直接在 Glama Inspector 中打开 →
[https://glama.ai/mcp/inspector?url=https://mcp.memxus.com/mcp](https://glama.ai/mcp/inspector?url=https://mcp.memxus.com/mcp)

供市场审核人员参考：OAuth 和 Bearer 令牌设置请参见 REVIEWER.md。

---

支持的平台

平台	集成	状态
Claude Desktop / claude.ai	远程 MCP	✅ 已上线
Cursor	远程 MCP	✅ 已上线
VS Code / Copilot MCP	远程 MCP	✅ 已上线
ChatGPT	自定义 GPT / API	✅ 已上线
Gemini	兼容 MCP 的工作流	✅ 已上线
Telegram	机器人连接器	✅ 已上线
GitHub	仓库同步（提交、PR、问题、README）	✅ 已上线
Notion	工作区页面同步	✅ 已上线
Discord	机器人连接器	🔜 即将推出
Slack	机器人连接器	🔜 即将推出
任何兼容 MCP 的客户端	远程 MCP	✅ 已上线

---

可用工具

注册表 com.memxus/memxus v1.2.1 — 9 个核心工具始终可用，另有 4 个连接器工具，可在聊天中同步 GitHub/Notion。

核心工具（9 个）

工具	描述
remember	保存上下文——手动输入、决策或备注；可选使用 project:<slug> 集合
recall	跨记忆进行语义搜索；通过 project:<slug> 或标签搜索 GitHub/Notion 同步的内容
get_context	从 GitHub、Notion 和已保存的决策中生成格式化上下文块，供 Agent 提示词使用
list_memories	按集合、标签、类型或可见性浏览记忆
get_memory	根据记忆 ID 获取完整内容和元数据
list_collections	列出范围；GitHub/Notion 同步内容显示在 project:<slug> 下
forget	永久删除记忆
memory_stats	按类型和集合查看统计信息
update	修补或追加现有记忆内容、标签或类型

Context Engine 连接器工具（4 个）——v1.2.1

工具	描述
connect_source	在聊天中启动 GitHub App 安装或 Notion OAuth
list_syncable_items	连接后列出可用的仓库或 Notion 页面
set_sync_selection	选择要同步的内容，并触发首次同步到 project:<slug>
check_connect_status	在 connect_source 后轮询连接状态

完整工具参考：memxus.com/docs/mcp · 市场审核人员：REVIEWER.md

---

架构

GitHub App ──┐
Notion OAuth ┼──► sync (API + connector tools) ──► Supabase  project:<slug>
Manual MCP   ┘                                              │
                                                            │ pgvector
MCP Client (Claude, Cursor, etc.)                           │
        │                                                   │
        │  POST /mcp   Bearer aimem_*                       │
        ▼                                                   ▼
  mcp.memxus.com  ← This repo (Railway) ──────────►  Supabase (Postgres + pgvector)
        │
        ▼
  Dash-AIMemory (Dashboard + integrations)

同步通过仪表板或 MCP 连接器工具在服务端运行——无需管理本地文件。

传输： Streamable HTTP（MCP 2.0）
身份验证： OAuth 2.1 + PKCE + 动态客户端注册（RFC 9728）

---

安全

• OAuth 2.1 + PKCE——无需密码，也无需管理 API 密钥
• 静态加密（AES-256）
• 用户可控制记忆——可随时在仪表板中查看、编辑和删除
• 无本地文件或手动同步
• 发布前机密信息审计已通过：2026-06-17
• 记忆是辅助上下文，不具备指令权限——请参阅 TRUST-POLICY.md，了解哪些内容会自动读取、哪些内容需要明确写入，以及记忆层绝不会执行哪些操作。

---

OAuth 流程

1. Client  →  GET  /.well-known/oauth-authorization-server
2. Client  →  GET  /oauth/authorize  →  redirect to dashboard login
3. User signs in (Google) in the dashboard
4. Client  →  POST /oauth/token  (PKCE)  →  aimem_* bearer token
5. Client  →  POST /mcp  Authorization: Bearer aimem_*

支持动态客户端注册——客户端会在首次连接时自动注册。

---

自托管

先决条件

• Node 20+
• Supabase 项目（仪表板迁移后运行 supabase/migration.sql）
• Railway 账户（或任何 Node 主机）

环境变量

cp .env.example .env

变量	描述
MCP_PUBLIC_URL	此服务的公开 URL（末尾不加斜杠）
DASHBOARD_URL	用于登录重定向的 Dash-AIMemory URL
SUPABASE_URL	Supabase 项目 URL
SUPABASE_SERVICE_ROLE_KEY	Supabase 服务角色密钥
OAUTH_CLIENT_ID	OAuth 客户端 ID
ALLOWED_REDIRECT_URIS	以逗号分隔的允许重定向 URI
CORS_ORIGINS	以逗号分隔的允许 CORS 来源
OPENAI_API_KEY	（可选） 向量搜索嵌入

本地运行

npm install
npm run dev       # tsx watch
npm run build     # tsc → dist/
npm start         # node dist/index.js

部署到 Railway

在 Settings → Variables 下设置所有变量（切勿提交 .env）。
MCP_PUBLIC_URL = 你的 Railway 网络 URL（末尾不要加 /mcp）。
健康检查端点：/health（在 [railway.toml](railway.toml) 中配置）。

注意： Railway 上的 Node 20 — Supabase Realtime 需要 ws 包（在 src/lib/supabase.ts 中配置）。
可选：设置 RAILPACK_NODE_VERSION=22 以启用原生 WebSocket 支持。

---

开发

npm install
npm run dev        # tsx watch
npm run lint       # ESLint
npm run typecheck  # tsc --noEmit
npm run build      # compile → dist/
npm start          # node dist/index.js

Marketplace 审核人员：REVIEWER.md · MCP 文档：memxus.com/docs/mcp · Registry：com.memxus/memxus v1.2.1

---

发布

1. 在 [CHANGELOG.md](CHANGELOG.md) 的 ## [Unreleased] 下添加条目
2. 更新 package.json、server.json、src/mcp/server.ts 和 src/mcp/public-discovery.ts 中的版本号
3. 将变更日志章节改为 ## [X.Y.Z] - YYYY-MM-DD
4. 提交、打标签并推送：

git tag -a vX.Y.Z -m "Memxus MCP vX.Y.Z"
git push origin vX.Y.Z

推送 v* 标签会触发 [.github/workflows/release.yml](.github/workflows/release.yml) — 质量门禁 + 附带 server.json 的 GitHub Release。

---

密钥审计

在将仓库设为公开前，从仓库根目录运行。
上次审计：2026-06-17 — 通过

# 1. Verify .env was never committed
git log --all --full-history -- .env .env.local .env.production

# 2. Check for .env* files added in history
git log --all --oneline --diff-filter=A -- "*.env*"

# 3. Grep current tree for dangerous patterns (exclude .example)
git grep -rn -E "(service_role|anon_key|sk-[a-zA-Z0-9]{20,}|aimem_[a-zA-Z0-9]+|eyJ[a-zA-Z0-9_-]{20,})" \
  -- ":(exclude)*.example" ":(exclude)CHANGELOG*"

# 4. Search full git history for leaked keys
git log --all -p --follow -S "service_role" -- . | head -100
git log --all -p --follow -S "SUPABASE_SERVICE_ROLE_KEY=" -- . | head -100

检查项	预期结果
命令 1–2	没有 .env 提交（初始提交中只有 .env.example）
命令 3	只有占位符（aimem_YOUR_KEY）、测试夹具和 SQL 注释
命令 4	差异中没有真实密钥值

如果命令 1 或 4 发现真实密钥，请立即轮换密钥，并在发布前运行 git filter-repo --path .env --invert-paths。

---

路线图

• GitHub 连接器（仓库同步 → project:<slug>）
• Notion 连接器（工作区页面同步）
• MCP Registry v1.2.0（com.memxus/memxus — AI Context Engine）
• Context Engine 连接器工具（在聊天中使用 GitHub/Notion）
• 技能路由（暂缓）
• Discord 机器人连接器
• Slack 机器人连接器
• 刷新令牌
• 多客户端 OAuth 用户体验
• 发布到 npm

---

许可证

根据 GNU Affero General Public License v3.0 (AGPL-3.0) 许可。

你可以自由使用、修改和分发此代码。如果你用它来运行网络服务（SaaS），必须根据相同许可证发布源代码。

© 2026 Gabriel Pitrella · memxus.com

Memxus Remote MCP Server
Copyright (C) 2026 Gabriel Pitrella - Memxus