OpenSEO
Keyword research, site audits, rank tracking and AI visibility for your AI agent.
Evidence-cited knowledge base for internal documents: audit trail, versioning, namespace isolation.
Elige la app de IA que usas y copia la configuración.
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Necesitas una clave de Memory Bridge (忆桥) (créala en el sitio del autor) · Instala Docker en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Memory Bridge (忆桥) para Claude en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "memory-bridge": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "MEMORY_BRIDGE_MCP_TOKEN", "ghcr.io/yanglinfeng/memory-bridge:1.0.1" ], "env": { "MEMORY_BRIDGE_MCP_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En MEMORY_BRIDGE_MCP_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Memory Bridge (忆桥) aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
docker --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl
Abrir la página de descarga de Docker ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version
Se instala una vez y sirve para todo lo que usa Docker
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
SettingsDeveloperEdit Config
{
"mcpServers": {
"memory-bridge": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MEMORY_BRIDGE_MCP_TOKEN",
"ghcr.io/yanglinfeng/memory-bridge:1.0.1"
],
"env": {
"MEMORY_BRIDGE_MCP_TOKEN": "your-value"
}
}
}
}Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Memory Bridge (忆桥) y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando Memory Bridge (忆桥) o muestra una herramienta de Memory Bridge (忆桥) en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
MEMORY_BRIDGE_USER_ID Trusted local principal the stdio session acts as. The image defaults it to 'default'; the server refuses to start when both this and MEMORY_BRIDGE_MCP_TOKEN are absent.MEMORY_BRIDGE_OLLAMA_URL Base URL of the Ollama runtime used for generation and embeddings. Inside a container this is usually http://host.docker.internal:11434.Las descripciones siguen en el inglés original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar Memory Bridge (忆桥)
Memory Bridge (忆桥) se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar Memory Bridge (忆桥)
Funciona con Claude Code, pero hay que preparar algo antes
Necesitas una clave de Memory Bridge (忆桥) (créala en el sitio del autor) · Instala Docker en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Memory Bridge (忆桥) para Claude Code en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user memory-bridge --env MEMORY_BRIDGE_MCP_TOKEN=your-value -- docker run -i --rm -e MEMORY_BRIDGE_MCP_TOKEN ghcr.io/yanglinfeng/memory-bridge:1.0.1 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En MEMORY_BRIDGE_MCP_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Memory Bridge (忆桥) aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
docker --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl
Abrir la página de descarga de Docker ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version
Se instala una vez y sirve para todo lo que usa Docker
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user memory-bridge --env MEMORY_BRIDGE_MCP_TOKEN=your-value -- docker run -i --rm -e MEMORY_BRIDGE_MCP_TOKEN ghcr.io/yanglinfeng/memory-bridge:1.0.1Cambia “your-value” por tu clave antes de pulsar Enter
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Deberías ver Memory Bridge (忆桥) en la lista como conectado
Usa Memory Bridge (忆桥) y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando Memory Bridge (忆桥) o muestra una herramienta de Memory Bridge (忆桥) en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
MEMORY_BRIDGE_USER_ID Trusted local principal the stdio session acts as. The image defaults it to 'default'; the server refuses to start when both this and MEMORY_BRIDGE_MCP_TOKEN are absent.MEMORY_BRIDGE_OLLAMA_URL Base URL of the Ollama runtime used for generation and embeddings. Inside a container this is usually http://host.docker.internal:11434.Las descripciones siguen en el inglés original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Necesitas una clave de Memory Bridge (忆桥) (créala en el sitio del autor) · Instala Docker en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Memory Bridge (忆桥) para Cursor en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "memory-bridge": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "MEMORY_BRIDGE_MCP_TOKEN", "ghcr.io/yanglinfeng/memory-bridge:1.0.1" ], "env": { "MEMORY_BRIDGE_MCP_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En MEMORY_BRIDGE_MCP_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Memory Bridge (忆桥) aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
docker --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl
Abrir la página de descarga de Docker ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version
Se instala una vez y sirve para todo lo que usa Docker
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
En la configuración de Memory Bridge (忆桥), MEMORY_BRIDGE_MCP_TOKEN está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Memory Bridge (忆桥) y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando Memory Bridge (忆桥) o muestra una herramienta de Memory Bridge (忆桥) en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
MEMORY_BRIDGE_USER_ID Trusted local principal the stdio session acts as. The image defaults it to 'default'; the server refuses to start when both this and MEMORY_BRIDGE_MCP_TOKEN are absent.MEMORY_BRIDGE_OLLAMA_URL Base URL of the Ollama runtime used for generation and embeddings. Inside a container this is usually http://host.docker.internal:11434.Las descripciones siguen en el inglés original.
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Necesitas una clave de Memory Bridge (忆桥) (créala en el sitio del autor) · Instala Docker en tu computadora primero (una sola vez)
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Memory Bridge (忆桥) para VS Code en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "memory-bridge": { "type": "stdio", "command": "docker", "args": [ "run", "-i", "--rm", "-e", "MEMORY_BRIDGE_MCP_TOKEN", "ghcr.io/yanglinfeng/memory-bridge:1.0.1" ], "env": { "MEMORY_BRIDGE_MCP_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En MEMORY_BRIDGE_MCP_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Memory Bridge (忆桥) aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
docker --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl
Abrir la página de descarga de Docker ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version
Se instala una vez y sirve para todo lo que usa Docker
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
En la configuración de Memory Bridge (忆桥), MEMORY_BRIDGE_MCP_TOKEN está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Memory Bridge (忆桥) y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando Memory Bridge (忆桥) o muestra una herramienta de Memory Bridge (忆桥) en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
MEMORY_BRIDGE_USER_ID Trusted local principal the stdio session acts as. The image defaults it to 'default'; the server refuses to start when both this and MEMORY_BRIDGE_MCP_TOKEN are absent.MEMORY_BRIDGE_OLLAMA_URL Base URL of the Ollama runtime used for generation and embeddings. Inside a container this is usually http://host.docker.internal:11434.Las descripciones siguen en el inglés original.
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --scope user memory-bridge --env MEMORY_BRIDGE_MCP_TOKEN=your-value -- docker run -i --rm -e MEMORY_BRIDGE_MCP_TOKEN ghcr.io/yanglinfeng/memory-bridge:1.0.1Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"memory-bridge": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MEMORY_BRIDGE_MCP_TOKEN",
"ghcr.io/yanglinfeng/memory-bridge:1.0.1"
],
"env": {
"MEMORY_BRIDGE_MCP_TOKEN": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"memory-bridge": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MEMORY_BRIDGE_MCP_TOKEN",
"ghcr.io/yanglinfeng/memory-bridge:1.0.1"
],
"env": {
"MEMORY_BRIDGE_MCP_TOKEN": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"memory-bridge": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MEMORY_BRIDGE_MCP_TOKEN",
"ghcr.io/yanglinfeng/memory-bridge:1.0.1"
],
"env": {
"MEMORY_BRIDGE_MCP_TOKEN": "your-value"
}
}
}
}MEMORY_BRIDGE_USER_ID envMEMORY_BRIDGE_MCP_TOKEN secreto obligatorio envMEMORY_BRIDGE_OLLAMA_URL envLas descripciones siguen en el inglés original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
oci: ghcr.io/yanglinfeng/memory-bridge:1.0.1Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 15 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub yanglinfeng, dueña del repo
Último cambio de código: hace 30 días
Usa Apache-2.0
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
No revisado: solo se pueden revisar paquetes npm y PyPI con versión
Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
Debes completar: MEMORY_BRIDGE_MCP_TOKEN
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez hace 30 días, y la última versión (1.0.1) llegó al registro hace 30 días.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Docker en tu computadora.
En la misma categoría: OpenSEO, Exa, Mockserver, Microsoft Learn MCP, Docs
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Keyword research, site audits, rank tracking and AI visibility for your AI agent.
Connect AI agents to Exa for web search, content fetching, and multi-step research.
Mock, record/replay, verify and chaos-test any HTTP, REST, gRPC or LLM dependency over MCP.
Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.
Search and read Empryo's documentation. Read-only, no auth, no local access.
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
Local-first, evidence-backed knowledge & memory layer for MCP.
内网 AI 知识库引擎 —— 企业文档问答 / 制度与合同检索 / 私有化部署,每个答案带逐句出处与可回放 traceId;同时是不绑定任何客户端的 MCP 长记忆中间件。
30 秒跑起来(无需本机 Node,无需构建):
docker run -i --rm -v memory-bridge-data:/data ghcr.io/yanglinfeng/memory-bridge:latest
已发布到官方 MCP Registry(io.github.yanglinfeng/mcp-memory-bridge),多架构镜像见 GHCR。
EN — Memory Bridge answers three questions most RAG / memory stacks skip: *where did this sentence come from*, *is the source still valid*, and *who can see it*. Every answer carries source bindings and a retrieval
traceId; every change is audited; every namespace is isolated. By default, model requests go to local Ollama. If you configure a remote model endpoint, the relevant prompts and context are sent there.
AI 知识库最大的风险不是答不出,是编造和引用已废止的文件。忆桥给回答配出处、给变更留审计、给部门数据上隔离。默认配置使用本机 Ollama;如果将模型地址配置为远程服务,相关提示词和上下文会发送到该服务。
你在搭企业内部知识库,并且满足下面任意一条:
| 你的场景 | 忆桥对应的能力 |
|---|---|
| 员工问的是制度、流程、合同、售后记录这类有版本、有归属的文档 | 文档级版本链,内容变更自动轮替,旧版本退出默认检索但仍可审计 |
| 你被要求回答「这条结论出自哪份文件哪一段」 | 逐句来源绑定 + 可回放的 traceId |
| 不同部门不能看到彼此的资料 | 用户 / 命名空间 / 作用域三层隔离 + 可信会话签发 |
| 数据不能出内网 | 本地优先,默认本机 Ollama,无外部依赖 |
也就是说:企业知识库 / 内网文档问答 / 制度与合同检索 / 私有化部署,以及在这些场景下的长记忆层——忆桥同时是不绑定任何客户端的 MCP 记忆中间件,可直接接进 Claude Desktop、Cline、Cursor 等客户端。
反过来,如果你只是想让 AI 记住你的代码风格偏好,或者想要一个托管在云上的记忆服务,忆桥不是最优选择——它的强项是可审计,代价是要你自己部署。
| 企业落地绕不开的问题 | 忆桥的机制 |
|---|---|
| 这句话的出处是哪份文件的哪一段? | 非破坏式巩固逐句绑定来源,每次召回带 traceId,可回放「查询改写 → 候选 → 融合 → 重排 → 选择 → 注入」全程 |
| 文件改版了,旧答案还会被引用吗? | 文档级版本链:内容变更自动走 supersede,旧版本退出默认检索,历史版本仍可审计回溯 |
| 谁能看见、谁改过? | 用户 / 命名空间 / 作用域三层隔离 + 可信会话签发与授权矩阵 + 全操作审计日志 |
检索与问答
bge-reranker-v2-m3 Python sidecar,按语料域(policy / open)分档相关性门槛calculator / date_diff / date_shift——算术与日期交给代码算,不让模型口算valid_from / valid_to 约束接入面
memory_remember · memory_recall · memory_get_context · memory_update · memory_forget · memory_list · memory_stats;确定性求解 3 个 —— answer_calculator · answer_date_diff · answer_date_shift记忆治理
工程底座
node:sqlite)+ outbox / jobs:租约、重试、dead letter、崩溃重放、幂等执行qwen2.5:14b、embedding bge-m3:latest(Ollama),无需云服务前置:Node.js ≥ 24,Ollama 已运行(Docker 方式不需要本机 Node)。
ollama pull qwen2.5:14b
ollama pull bge-m3:latest
方式 A —— 官方镜像(推荐,零构建)
docker run -i --rm -v memory-bridge-data:/data ghcr.io/yanglinfeng/memory-bridge:latest
镜像同时提供 linux/amd64 与 linux/arm64(Apple Silicon 原生运行,不走模拟)。
方式 B —— npx(只接 MCP 客户端)
注:npm 包
mcp-memory-bridge尚在发布准备中。若此命令报 404,请改用方式 A 或 C。
MEMORY_BRIDGE_USER_ID=default npx -y mcp-memory-bridge
方式 C —— 从源码运行(管理台 / 开发)
git clone https://github.com/yanglinfeng/memory-bridge.git
cd memory-bridge npm install npm run build npm start # HTTP 服务 + 管理台:http://127.0.0.1:3789
首次启动为空记忆库——没有演示数据,管理台只展示真实写入的内容。
容器里跑 HTTP 模式要注意:忆桥只监听回环地址(
127.0.0.1/::1),这是有意的安全
契约——服务信任 loopback 上的无令牌请求。所以容器里不能用
-p 3789:3789做端口映射
(映射到的是容器自己的回环,宿主机连不上),请改用
--network host(Docker Desktop 需先
在设置里启用 host networking)。完整说明见 Dockerfile 头部注释。
接入任意 MCP 客户端(Claude Desktop / Cline / …),用官方镜像最省事:
{
"mcpServers": { "memory-bridge": { "command": "docker", "args": [ "run", "-i", "--rm", "-v", "memory-bridge-data:/data", "ghcr.io/yanglinfeng/memory-bridge:latest" ] } } }
从源码运行时改用绝对路径:
{
"mcpServers": { "memory-bridge": { "command": "node", "args": ["/absolute/path/to/memory-bridge/dist/server/mcp-stdio.js"], "env": { "MEMORY_BRIDGE_USER_ID": "default" } } } }
MEMORY_BRIDGE_USER_ID(或改用 MEMORY_BRIDGE_MCP_TOKEN)是必填项——两者都缺时服务会拒绝 启动。镜像里已内置 MEMORY_BRIDGE_USER_ID=default,所以 Docker 方式无需再配。 npm 包发布后,也可改用 "command": "npx" 与 "args": ["-y", "mcp-memory-bridge"]。
三个零构建、可直接运行的最小示例(curl / Node / Java),覆盖写入(含 corpusDomain / classification)、幂等重放、召回、supersede 改版与时序对照查询:
export MB_TOKEN=你的令牌 # 见 examples/README.md §1
bash examples/curl/quickstart.sh node examples/node/quickstart.mjs java examples/java/QuickStart.java # JDK 17+,零依赖
文档里声明的 schema 版本、环境变量、npm 脚本、HTTP 路由与配置默认值,可以和代码事实一键对撞:
npm run check:docs
它会把「文档说的」与「代码里的」逐项比对并在不一致时以非零退出码失败,适合在发布前与每次 大改后重跑。见 CONTRIBUTING.md。
完整安装、运维、接口与排障文档从 docs/README.md 进入; 基准评测的条件与一键复现见 BENCHMARKS.md。
忆桥自带评测与压测链路(scripts/ 下 40+ 个可执行脚本,覆盖检索、重排、巩固、命名空间隔离、上下文反思、规模、可靠性与崩溃恢复),并在 docs/acceptance-report-*.md 中保留带日期与环境的证据快照。
公开基准(英文知识库问答、中文自建集)的条件与一键复现脚本已列在 [`BENCHMARKS.md`](BENCHMARKS.md)。 其中包含数据准备与运行限制;大规模延迟压测仍是项目内部评测,不作为公开基准。在数字可复现之前,README 不主张任何分数——这是本项目「可信层」定位的一部分。
| 维度 | 忆桥 | mem0 | Zep / Graphiti | RAGFlow | AnythingLLM |
|---|---|---|---|---|---|
引用可验证(来源绑定 + traceId) | ✅ | — | — | ✅ | 部分 |
| 时序有效性(版本替代退出检索) | ✅ 文档级 | — | ✅ 事实级 | — | — |
| 全操作审计日志 | ✅ | 企业版 | ✅ | — | — |
| 命名空间 / 部门隔离 | ✅ 可信会话 + 授权矩阵 | 企业版 | ✅ | 团队级 | Workspace |
| 遗忘与纠正(tombstone / 版本追加) | ✅ | ✅ | ✅ | — | — |
| 可配置为全离线(模型端点也在本机) | ✅ | 部分 | — | ✅ | ✅ |
| MCP 原生 | ✅ 7 工具 | ✅ | 社区封装 | ✅ | — |
本表只列架构上有无,不评分数高低。各项目迭代都很快,请以各自仓库为准。
BENCHMARKS.md:公开基准的完整条件与一键复现(npm run bench:cn / bench:cmrc / bench:hotpotqa)CONTRIBUTING.md / SECURITY.md / CHANGELOG.md / CODE_OF_CONDUCT.md,附 .env.example 与 examples/(curl / Node / Java)npm run check:docs(发布前与每次大改后重跑)supersede 时补写 valid_to,并补 as-of 查询的回归测试test:lifecycle 的 2 例 doctor 经查是 Node 版本低于 engines >= 24 所致,非代码缺陷README.en.md(核心指南英文版仍待补)pretest 加 Node 版本守卫:engines 在 npm 里只是警告、不阻断执行, Node < 24 跑 npm test 会稳定看到 2 例假红灯关于开源边界的说明。 忆桥的定位是「可信层」,而可信必须可被验证——所以证据绑定、版本链、
审计日志、命名空间隔离这些构成可信层的能力,全部在本仓库、全部 Apache-2.0、且不会改为闭源。
只有两类东西不在本仓库内:企业内网的文档摄取与权限落地(解析、章节切分、ACL 裁剪、审核流、
图像链路),以及交付与运维工程(离线交付包、升级回滚、合规审计导出、带 SLA 的支持)。
它们作为独立模块提供商业支持,不影响本仓库的完整可用性——独立部署本仓库就是完整可用的内核。
| 事项 | 走哪个通道 |
|---|---|
| 缺陷报告 | Issues · 缺陷报告模板 |
| 功能建议 | Issues · 功能建议模板 |
| 私有化部署实施 / 商业支持与 SLA / 定制开发 | Issues · 商业合作模板 或 Discussions 的 Commercial 分类 |
| 用法讨论、部署求助、调优经验 | Discussions |
| 安全漏洞 | Security Advisories —— 请勿为安全问题开公开 Issue,处理流程见 SECURITY.md |
维护者是个人开发者(@yanglinfeng),不开空头 SLA;缺陷会按「是否影响 出处可验证 / 版本可追溯 / 权限可隔离」排序,商务类咨询优先回复。
本项目以 Apache-2.0 授权。公司内部自用、二次开发、集成进内部系统,乃至打包进你们对外销售的产品,都不需要向我们申请授权——这是 Apache-2.0 已经给到你的权利,我们不会事后收回。
既然如此,什么情况下才需要联系?答案是需要责任,而不是许可:
| 你需要的是 | 怎么走 |
|---|---|
| 私有化部署实施、模型选型与调优、历史数据迁移 | 商业合作表单 |
| 带明确响应时间的 SLA、年度维护与升级保障 | 商业合作表单 |
| 企业内网场景的文档摄取、章节切分与权限落地 | 商业合作表单 |
| 只是想用起来 | 不必联系,git clone 即可 |
「忆桥 / Memory Bridge」名称与标识不在 Apache-2.0 的授权范围内(见许可证第 6 条)。二次分发请使用你自己的产品名,不要让人误以为出自本项目官方。