🚀 使用 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文件。