services:
  teslamate-mcp:
    image: ghcr.io/6547709/teslamate-mcp:latest
    container_name: teslamate-mcp
    restart: always
    ports:
      - "30002:8080"              # 主机端口:容器端口
    environment:
      # ── TeslaMate 数据库（必填）─────────────────────────
      - TESLAMATE_DB_HOST=database      # PostgreSQL 主机（同一 Docker 网络下用 database）
      - TESLAMATE_DB_PORT=5432          # PostgreSQL 端口
      - TESLAMATE_DB_USER=teslamate     # 数据库用户名
      - TESLAMATE_DB_PASS=secret        # 数据库密码  ← 请修改
      - TESLAMATE_DB_NAME=teslamate     # 数据库名称

      # ── 服务模式 ───────────────────────────────────────
      - MCP_TRANSPORT=streamable-http   # stdio=命令行模式，streamable-http=容器模式
      - HTTP_HOST=0.0.0.0              # 绑定地址（⚠️ 暴露公网前请加反向代理认证）
      - HTTP_PORT=8080                 # 容器内部端口
      # - MCP_DEBUG=false              # 设为 true 开启详细日志

      # ── 数据库连接池（v1.2.5 新增）────────────────────────
      # - TESLA_DB_MAXCONN=8              # 连接池上限（默认 8，按并发调整）
      # - TESLA_DB_MINCONN=2              # 连接池下限（默认 2）
      # - TESLA_DB_POOL_RETRY_WINDOW_SEC=2.0  # 池耗尽重试窗口
      # - TESLA_DB_POOL_RETRY_SLEEP_SEC=0.05  # 重试步长

      # ── 时区 ───────────────────────────────────────────
      - TIMEZONE=Asia/Shanghai          # IANA 时区名（如 Asia/Shanghai、America/Los_Angeles）

      # ── 单位与货币 ─────────────────────────────────────
      - USE_METRIC_UNITS=true           # true=公里/摄氏度/¥/Wh/km，false=英里/华氏度/$/Wh/mi
      - TESLA_ELECTRICITY_RATE_RMB=0.6  # 电费（元/度）
      # - TESLA_ELECTRICITY_RATE_USD=0.12  # 电费（美元/度，fallback）
      # - TESLA_GAS_PRICE=3.50          # 油价（美元/加仑，用于节省计算）
      # - TESLA_GAS_MPG=28              # 燃油车油耗（MPG，用于节省计算）

      # ── 车辆参数（多车配置）────────────────────────────
      # JSON 格式：key = TeslaMate car_id，value = {kwh, range_km}
      # 所有工具均支持 car_id 参数来查询指定车辆；设置后将覆盖单车默认值
      - TESLA_CAR_PARAMS={"1":{"kwh":78.4,"range_km":675},"2":{"kwh":82,"range_km":751}}
      #   ├─ car_id=1：Model 3P 国产高性能版（改款二 / 2021.12）：78.4 kWh, 675 km CLTC
      #   └─ car_id=2：Model YL 长续航六座版（2025.08）：82.0 kWh, 751 km CLTC
      # 如只跑单车，下面的 TESLA_BATTERY_KWH + TESLA_BATTERY_RANGE_KM 仍生效
      # - TESLA_BATTERY_KWH=78.4          # 可用电池容量（kWh，单车回退）
      # - TESLA_BATTERY_RANGE_KM=675      # 满电续航（km，单车回退）
      - TESLA_CAR_ID=1                  # 默认车辆 ID（查看 TeslaMate 仪表盘）

      # ── 胎压阈值（可选）────────────────────────────────
      # - TESLA_TPMS_MIN_THRESHOLD=2.5  # 低压警告阈值（bar）
      # - TESLA_TPMS_MAX_THRESHOLD=3.5  # 高压警告阈值（bar）

      # ── 吸血鬼 / 露营阈值（可选）─────────────────────────
      # - TESLA_VAMPIRE_MIN_HOURS=8     # 最短停放判定时长（小时）
      # - TESLA_VAMPIRE_MAX_HOURS=168   # 最长停放判定时长（小时）
      # - TESLA_VAMPIRE_WEATHER_MAX=5   # 附天气查询的掉电事件数（v1.2.3+）
      # - TESLA_CAMPING_KWH_PER_HOUR=0.8 # 露营模式阈值（kWh/h，参考 75 kWh）

      # ── 性能 / 缓存（v1.2.5 新增）────────────────────────
      # - TESLA_LIMIT_NARRATIVE=500       # narrative 最多返回行程数
      # - TESLA_ROUTINE_CACHE_MAX=256     # 常规地址缓存上限
      # - TESLA_GEOCODE_CACHE_MAX=1000    # 持久化地理编码缓存条目上限
      # - TESLA_GEOCODE_CACHE_DEBOUNCE_SEC=1.0  # 写盘去抖窗口（v1.2.5）
      # - TESLA_MAX_LOOKBACK_DAYS=3650    # 全工具统一最大回溯天数

      # ── 第三方 API（可选）⚠️ 占位符，必须替换成自己申请的！────
      # 高德地图 / AMAP：提升中文地址地理编码精度（tesla_trip_cost）
      #   申请：https://lbs.amap.com → 创建应用 → 选「Web服务」类型 Key
      # - AMAP_API_KEY=xxx***                          # 你的高德 Web服务 Key
      # - TESLA_AMAP_TIMEOUT=8                          # 可选，请求超时（秒）
      # 和风天气 / QWeather：启用 tesla_weather、tesla_efficiency_by_weather、行程成本天气修正
      #   申请：https://dev.qweather.com → 控制台 → 创建项目，获取 API Key + 账号专属 Host
      #   注意：必须用账号专属 Host（形如 xxxx.re.qweatherapi.com），旧公共域名返回 403
      # - QWEATHER_API_KEY=xxx***                       # 你的和风天气 API Key
      # - QWEATHER_API_HOST=xxx***.re.qweatherapi.com   # 你的专属 Host
      # - TESLA_QWEATHER_TIMEOUT=8                       # 可选，请求超时（秒）
      # - TESLA_WEATHER_SAMPLE_MAX=60                    # 可选，天气能效分析采样行程数

      # ── 查询限制（可选，设 -1 为不限制）────────────────
      # - TESLA_LIMIT_DRIVES=500             # tesla_drives 最大返回条数
      # - TESLA_LIMIT_CHARGING=500           # tesla_charging_history 最大返回条数
      # - TESLA_LIMIT_TRIP_CATEGORIES=500    # tesla_trip_categories 分析行程数
      # - TESLA_LIMIT_BATTERY_HEALTH=60      # tesla_battery_health 月度快照数
      # - TESLA_LIMIT_BATTERY_SAMPLES=30     # tesla_battery_health 回退采样数
      # - TESLA_LIMIT_LOCATION_HISTORY=50    # tesla_location_history 位置聚类数
      # - TESLA_LIMIT_STATE_HISTORY=500      # tesla_state_history 状态转换数
      # - TESLA_LIMIT_SOFTWARE_UPDATES=30    # tesla_software_updates 软件更新数
      # - TESLA_LIMIT_CHARGING_BY_LOCATION=50  # tesla_charging_by_location 充电地点数
      # - TESLA_LIMIT_TPMS_HISTORY=60        # tesla_tpms_history 胎压历史数
      # - TESLA_LIMIT_VAMPIRE_DRAIN=50       # tesla_vampire_drain 掉电事件数
    depends_on:
      - database

docker-compose up -d teslamate-mcp

docker logs teslamate-mcp

Uvicorn running on http://0.0.0.0:8080 (Press CTRL+C to quit)

{
  "mcpServers": {
    "teslamate": {
      "url": "http://192.168.10.200:30002/mcp"
    }
  }
}

{
  "mcpServers": {
    "tesla": {
      "url": "http://192.168.10.200:30002/mcp"
    }
  }
}

┌─────────────┐     ┌──────────────┐     ┌───────────┐     ┌────────────┐
│  TeslaMate   │────▶│   Postgres   │────▶│ tesla.py  │────▶│ MCP 客户端  │
│  (数据记录)   │     │  (TeslaMate) │     │(HTTP/:8080)│     │(OpenClaw,   │
└─────────────┘     └──────────────┘     └───────────┘     │Claude Code) │
                                                            └────────────┘

# 打标签发布
git tag v1.2.4
git push origin v1.2.4