Mcp Memory Bank

🐳 使用 Docker 运行

本项目已全面支持 Docker，便于部署和本地开发。提供的 Dockerfile 和 docker-compose.yml 会同时配置主应用及其所需的 ChromaDB 向量数据库。

要求

• Docker（最新稳定版）
• Docker Compose（建议使用 v2+）

环境变量

以下环境变量为默认使用的变量（可在环境中或通过 docker-compose.yml 覆盖）：

CHROMADB_URL=http://chromadb:8000
TRANSPORT=http
HTTP_PORT=3000
MCP_MEMBANK_EMBEDDING_MODEL=Xenova/all-MiniLM-L6-v2
NODE_ENV=production
NODE_OPTIONS=--max-old-space-size=4096

构建并运行

构建并启动所有服务：

docker-compose up --build -d

这将：

• 构建主 TypeScript 应用（Node.js v22.13.1-slim）
• 启动名为 ts-app 的应用（监听端口 3000）
• 启动名为 chromadb 的 ChromaDB（监听端口 8000）
• 为 ChromaDB 数据创建持久化卷
• 设置共享 Docker 网络，以便服务间通信

端口

• 3000：主应用 HTTP API（ts-app）
• 8000：ChromaDB 向量数据库（chromadb）

数据持久化

• ChromaDB 数据持久化存储在名为 chromadb-data 的 Docker 卷中。
• 应用数据目录（/app/data）会在容器内创建，并归非 root 用户所有。

特别说明

• 应用要求 ChromaDB 可通过 CHROMADB_URL 指定的 URL 访问（默认值：http://chromadb:8000）。
• 可通过 MCP_MEMBANK_EMBEDDING_MODEL 环境变量更改嵌入模型。
• 如需自定义环境变量，请编辑 docker-compose.yml 或使用 .env 文件。

---