AI导哈

特斯拉数据查询服务

TeslaMate MCP Server 是一个模型上下文协议（MCP）服务器，提供对 TeslaMate 数据库的访问，允许AI助手查询特斯拉车辆数据和分析。该服务通过连接 TeslaMate 的 PostgreSQL 数据库，提供车辆信息、驾驶统计、充电数据、电池健康、效率指标和位置分析等多种工具。

  • by cobanov
  • 96 星标
  • 更新于
在 GitHub 查看 cobanov/teslamate-mcp

使用说明

基本能力

产品定位

TeslaMate MCP Server 是一个专门用于查询和分析特斯拉车辆数据的服务，通过与 TeslaMate 数据库集成，提供丰富的车辆数据查询工具。

核心功能

  1. 提供20种工具用于查询特斯拉车辆数据，包括车辆基本信息、当前状态、软件更新历史、电池健康摘要、电池退化趋势、每日电池使用模式、轮胎压力趋势、月度驾驶摘要、每日驾驶模式、最长驾驶距离、总距离和效率、每日驾驶摘要、按温度和月份的效率分析、异常功耗检测、按位置的充电统计、所有充电会话摘要、最常访问的位置等。
  2. 支持自定义SQL查询，仅允许SELECT语句，确保数据安全。
  3. 提供本地和远程部署选项，支持Docker部署。
  4. 可选的身份验证机制，保障远程访问安全。

适用场景

  1. 特斯拉车主希望通过自然语言查询车辆数据。
  2. 开发者需要集成特斯拉车辆数据到AI助手或其他应用中。
  3. 数据分析师需要对特斯拉车辆数据进行深入分析和可视化。

工具列表

  1. get_basic_car_information - 获取车辆基本信息（VIN、型号、名称、颜色等）
  2. get_current_car_status - 获取当前车辆状态、位置、电池电量和温度
  3. get_software_update_history - 获取软件更新时间线
  4. get_battery_health_summary - 获取电池退化和健康指标
  5. get_battery_degradation_over_time - 获取历史电池容量趋势
  6. get_daily_battery_usage_patterns - 获取每日电池消耗模式
  7. get_tire_pressure_weekly_trends - 获取轮胎压力历史和趋势
  8. get_monthly_driving_summary - 获取月度距离、效率和驾驶时间
  9. get_daily_driving_patterns - 获取每日驾驶习惯和模式
  10. get_longest_drives_by_distance - 获取按距离排名的顶级驾驶详情
  11. get_total_distance_and_efficiency - 获取总体驾驶统计
  12. get_drive_summary_per_day - 获取每日驾驶摘要
  13. get_efficiency_by_month_and_temperature - 获取按温度和月份的效率分析
  14. get_average_efficiency_by_temperature - 获取温度对效率的影响
  15. get_unusual_power_consumption - 检测异常功耗
  16. get_charging_by_location - 获取按位置的充电统计
  17. get_all_charging_sessions_summary - 获取完整充电历史摘要
  18. get_most_visited_locations - 获取最常访问的地点
  19. get_database_schema - 获取完整数据库架构（表、列、数据类型）
  20. run_sql - 执行自定义SELECT查询（带安全验证）

使用教程

使用依赖

  1. 运行 TeslaMate 并配置 PostgreSQL 数据库
  2. Python 3.11 或更高版本
  3. 访问 TeslaMate 数据库的权限

安装教程

选项1：本地安装

  1. 克隆仓库：
    git clone https://github.com/yourusername/teslamate-mcp.git
cd teslamate-mcp
  2. 安装依赖（推荐使用uv）：
    uv sync
    或使用pip：
    pip install -r requirements.txt
  3. 在项目根目录创建 .env 文件：
    DATABASE_URL=postgresql://username:password@hostname:port/teslamate

选项2：Docker部署（远程访问）

  1. 克隆仓库：
    git clone https://github.com/yourusername/teslamate-mcp.git
cd teslamate-mcp
  2. 运行部署脚本：
    ./deploy.sh deploy
    或手动：
    cp env.example .env
# 编辑.env文件，填入数据库凭证
docker-compose up -d

调试方式

  1. 运行服务器（STDIO）：
    uv run python main.py
  2. 使用curl测试远程服务器：
    curl -H "Authorization: Bearer your-secret-bearer-token-here" http://localhost:8888/mcp

相关 MCP