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 網絡以實現服務間通信

端口

數據持久化

• ChromaDB 數據會持久化存儲在名為 chromadb-data 的 Docker 命名存儲卷中。
• 應用數據目錄（/app/data）會被創建，且由容器內的非 root 用戶擁有。

特別說明

⚠️ 重要提示

• 該應用要求 ChromaDB 在 CHROMADB_URL 指定的 URL 上可用（默認：http://chromadb:8000）。
• 嵌入式模型可通過 MCP_MEMBANK_EMBEDDING_MODEL 環境變量進行更改。
• 如果需要自定義環境變量，可編輯 docker-compose.yml 文件或使用 .env 文件。