特斯拉伴侣-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