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

1. 安装依赖（推荐使用uv）：

   uv sync

或使用pip：

   pip install -r requirements.txt

1. 在项目根目录创建 .env 文件：

   DATABASE_URL=postgresql://username:password@hostname:port/teslamate

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

1. 克隆仓库：

   git clone https://github.com/yourusername/teslamate-mcp.git
   cd teslamate-mcp

1. 运行部署脚本：

   ./deploy.sh deploy

或手动：

   cp env.example .env
   # 编辑.env文件，填入数据库凭证
   docker-compose up -d

调试方式

1. 运行服务器（STDIO）：

   uv run python main.py

1. 使用curl测试远程服务器：

   curl -H "Authorization: Bearer your-secret-bearer-token-here" http://localhost:8888/mcp