環境配置

本系統主要透過環境變數 (Environment Variables) 進行配置。

快速開始

專案根目錄提供了 .env.example 範本檔案，請複製並修改：

cp .env.example .env

然後根據您的部署環境編輯 .env 檔案。

MCP 傳輸模式配置

系統支援三種 MCP 傳輸模式，透過 MCP_TRANSPORT 環境變數設定：

stdio 模式（本地開發）

適用於 Claude Desktop 等本地整合環境：

MCP_TRANSPORT=stdio

http 模式（生產部署）✨ 推薦

適用於 Docker 生產環境，使用 Streamable HTTP 協定：

MCP_TRANSPORT=http
MCP_HOST=0.0.0.0
MCP_PORT=8000
MCP_PATH=/mcp

連線 URL：http://localhost:8000/mcp

sse 模式（向後相容）

適用於 Colab + Ngrok 等場景，使用 Server-Sent Events：

MCP_TRANSPORT=sse
MCP_HOST=0.0.0.0
MCP_PORT=8000

連線 URL：http://localhost:8000/sse

完整環境變數清單

MCP 傳輸配置

變數名稱	預設值	說明
MCP_TRANSPORT	stdio	傳輸模式：stdio | http | sse
MCP_HOST	0.0.0.0	監聽主機（僅 http/sse 模式）
MCP_PORT	8000	監聽埠號（僅 http/sse 模式）
MCP_PATH	/mcp	HTTP 端點路徑（僅 http 模式）

系統配置

變數名稱	預設值	說明
DATA_DIR	/app/data	資料檔案儲存路徑 (包含 Excel, SQLite)
LOG_LEVEL	INFO	日誌層級 (DEBUG, INFO, WARNING, ERROR)

資料目錄結構

DATA_DIR 指向的路徑應包含以下檔案結構（容器啟動時會自動檢查或生成部分檔案）：

/data
├── icd10cm_pcs_xxxx.xlsx  (原始 ICD 資料)
├── drugs.db               (藥品資料庫 - 自動生成)
├── icd.db                 (ICD 資料庫 - 自動生成)
└── ...

調整記憶體限制

若在 Docker 中運行，建議透過資源限制參數保護宿主機：

# docker-compose.yml
services:
  mcp-server:
    deploy:
      resources:
        limits:
          memory: 4G