🚀 使用 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 网络以实现服务间通信

端口

数据持久化

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

特别说明

⚠️ 重要提示

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