内容
align="center">
<a href="https://membase.so">
<img src="docs/assets/banner.png" alt="Membase 插件/MCP — 官方连接器，用于将 Membase 集成到您的 AI 客户端" width="100%">
</a>
</p>
[](https://cursor.com/en/install-mcp?name=membase&eyJ1cmwiOiJodHRwczovL21jcC5tZW1iYXNlLnNvL21jcCJ9) [](https://insiders.vscode.dev/redirect/mcp/install?namease&config=%7B%22type%22%320%22http%22%2C%20%22url%22%3A%20%22https%3A%2F%2Fmcp.membase.so%2Fmcp%22%7D) [](./LICENSE) [](./ING.md) [](https://discord.gg/vHgtDd6UTK)
## 用例
大多数 AI 工具在聊天结束时都会忘记一切。您已经解释过的上下文 — 您的技术栈、偏好、上周做 — 必须在每次会话时重新解释，并且永远不会延续中。使用 Membase，您的代理共享一个持久的内存：
- **持久的项目上下文** — 您的代理记住您的技术栈、约定和过去的决定，而不是在每次会话时询问。
跨工具连续性** — 在 Claude Code 中捕获某些内容 或 Codex 中回忆，因为它们共享一个内存。
- **长期工作** — 拾取一个多天的任务，并自动将相关的历史记录拉回到上下文中。
- **个人知识** — 保存事实、偏好和笔记一次，让任何连接的代理按需检索它们。
## 安装
一个命令，每个检测到的客户端（Claude Code、Cursor、Codex）：
```bash
npx plugins add aristoapp/membase-plugin-mcp
```
或仅限 Claude Code，通过其插件市场：
```bash
claude plugin marketplace add aristoapp/membase-plugin-mcp
claude plugin install membase@membase-plugins
```
下面是每个客户端的手动设置。每個客戶端都连接到同一个托管的 MCP 服务器：`https://mcp.membase.so/mcp`。
<details>
<summary><b>Claude Code</b></summary>
```bash
claude mcp add --transport http membase https://mcp.membase.so/mcp
```
想要自动捕获和跨会话交接吗？安装 Membase **插件**（一个捆绑的 MCP 服务器和钩子）代替 — 仓库根目录是插件包；参见上面的安装命令或 [clients/claude](clients/claude)。
完整指南：[docs/install/claude.md](docs/install/claude.md)
</details>
<details>
<summary><b>Cursor</b></summary>
点击安装：
[](https://cursor.com/en/install-mcp?name=membase&config=eyJ1cmwiOiJodHRwczovL21jcC5tiYXNlLnNvL21jcCJ9)
或手动添加到 `.cursor.json`（该项目）或 `~/.cursor/mcp（所有项目）：
```json
{
"mcpServers": {
"membase "url": "https://mcp.membase.so/mcp"
}
}
完整指南：[docs/install/cursor.md](docs/install/cursor.md)
</details>
<details>
<summary><b>Codex CLI</b></summary>
```bash
codex mcp add membase --url https://mcp.membase.so/mcp
codex mcp login membase
```
或将其添加到 `~/.codex/config.toml`（全局）或 `.codex/config.toml`（该项目）：
```toml
[mcp_servers.membase]
url = "https://mcp.membase.so/mcp"
```
完整指南：[docs/install/codex.md](docs/install/codex.md)
</details>
<details>
<summary><b Code</b></summary>
点击安装：
[](https://insiders.vscode.dev/redirect/mcp/install?name=membase&config=%7B%22type%22%3A%20%22http%22%2C%20%22url%22%3A%20%22https%3A%2F%2Fmcp.membase.so%2Fmcp%22%7D)
或将其添加到您的 MCP 配置（`.vscode/mcp.json`）：
```json
{
"servers": {
"membase": {
"type": "http",
"url": "https://mcp.membase.so/mcp"
}
}
}
```
</details>
<details>
<summary><b>Hermes Agent></summary>
在 `~/.hermes/config.yaml` 中，在 `mcp_servers` 下添加服务器：
```yaml
mcp_servers:
membase:
url: "https://mcp.membase.so/mcp"
```
更喜欢原生集成？Hermes 还提供了一个 Python 提供程序包 — 请参阅 [clients/hermes](clients/hermes)。
完整指南：[docs/install/hermes.md](docs/install/hermes.md)
</details>
<details>
<summary><b>OpenClaw</b></summary>
**远程 MCP（最简单）**。 将 Membase 添加到您的 OpenClaw MCP 配置：
```json
{
"mcpServers": {
"membase": {
"url": "https://mcp.membase.so/mcp"
}
}
}
```
**原生插件（更丰富 — 自动捕获和召回）**。 从 OpenClaw 检查点：
```bash
openclaw plugins install --link ./clients/openclaw
openclaw plugins enable openclaw-membase
open restart
```
完整指南：[docs/install/openclaw.md/install/openclaw.md)
</details>
<details>
<summary><b MCP 主机</b>（ChatGPT、Gemini CLI、OpenCode、Poke、</summary>
任何具有 MCP 功能的主机都可以使用通用和首次使用时的 OAuth 提示进行连接：
```json
{
"mcpServers": {
"memb {
"url": "https://mcp.memb/mcp"
}
}
}
```
</details>
## 工具
每个连接器都连接到同一个托管的 MCP 工具集：
`add_memory` · `search_memory` · `add` · `search_wiki` · `update_wiki` · `delete_wiki` · `get_current_date`
具有原生运行时（Claude Code、OpenClaw、Hermes）的内存自动化：只需工作，您的会话就会被捕获、回忆和为您交接。每个客户端安装指南中的详细信息。
任何重要的内容，请保存并稍后取回 — 普通语言就足够，代理为您调用工具：
```txt
记住，我们从 release 分支部署，而不是 分支。
```
```txt
上周我们决定了什么关于身份验证流程的问题？
```
```txt
保存这个：暂存数据库每天凌晨 02:00 UTC 重置。
```
## 工作原理
连接器与稳定的 Membase 上下文 API 对话。
```text
客户端插件或 MCP 配置 ← 每个客户端适配器（clients/*）
│
▼
共享连接器核心 ← packages/core，packages/connector-sdk
│
▼
Membase 上下文 API ← 稳定的公共表面
│
▼
私有 Memb内存引擎 ← 存储，排名（不在中）
```
客户端特定行为保留在 `clients/*`；共享行为存在packages/*` 中。
有关完整的设计原理，请参阅 [docs/architecture.md](docs/architecture.md)和 [MAP.md](MAP.md) 中的“X 存放在哪里”的地图。
> **注意：** 此仓库仅是连接器/集成层。Membase 上下文 API、内存引擎及其支持服务是一个单独的私有系统，不属于此仓库。
## 贡献
欢迎贡献 — 新的连接器、错误修复、文档、性能优化。这是一个 [pnpm](https://pnpm.io) 多元仓库（Node.js 20+，pn11+）：
```bash
pnpm install
pnpm test # 运行时 + 契约套件
pnpm check # 与您的 PR 运行的相同的门控 CI
```
详见 [CONTRIBUTING.md](CONTRIBUTING.md)；请同时查看我们的 [行为准则](CODE_OF_CONDUCT.md)。
## 安全
有关安全问题，请参
