diff --git a/.env.example b/.env.example
index f1da105..d37e415 100644
--- a/.env.example
+++ b/.env.example
@@ -15,7 +15,9 @@ JINA_API_KEY=your_jina_key_here
 # System Configuration (Docker default paths)
 RUNTIME_ENV_PATH=/app/data/runtime_env.json
 
-# MCP Service Ports (defaults shown)
+# MCP Service Host Ports (exposed on host machine)
+# Container always uses 8000-8003 internally
+# Change these if you need different ports on your host
 MATH_HTTP_PORT=8000
 SEARCH_HTTP_PORT=8001
 TRADE_HTTP_PORT=8002
diff --git a/docker-compose.yml b/docker-compose.yml
index 91a85df..d0ac2cd 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -19,18 +19,19 @@ services:
       # System Configuration
       - RUNTIME_ENV_PATH=/app/data/runtime_env.json
 
-      # MCP Service Ports
-      - MATH_HTTP_PORT=${MATH_HTTP_PORT:-8000}
-      - SEARCH_HTTP_PORT=${SEARCH_HTTP_PORT:-8001}
-      - TRADE_HTTP_PORT=${TRADE_HTTP_PORT:-8002}
-      - GETPRICE_HTTP_PORT=${GETPRICE_HTTP_PORT:-8003}
+      # MCP Service Ports (fixed internally)
+      - MATH_HTTP_PORT=8000
+      - SEARCH_HTTP_PORT=8001
+      - TRADE_HTTP_PORT=8002
+      - GETPRICE_HTTP_PORT=8003
 
       # Agent Configuration
       - AGENT_MAX_STEP=${AGENT_MAX_STEP:-30}
     ports:
-      - "8000:8000"
-      - "8001:8001"
-      - "8002:8002"
-      - "8003:8003"
+      # Format: "HOST:CONTAINER" - container ports are fixed, host ports configurable via .env
+      - "${MATH_HTTP_PORT:-8000}:8000"
+      - "${SEARCH_HTTP_PORT:-8001}:8001"
+      - "${TRADE_HTTP_PORT:-8002}:8002"
+      - "${GETPRICE_HTTP_PORT:-8003}:8003"
       - "8888:8888"
     restart: unless-stopped