用途
本 MCP 服务器将 TeslaMate 的历史数据分析能力与 Tesla Fleet API 的实时数据和远程命令整合在一起,面向需要通过 Claude Code、Claude Desktop、Cursor 或任何兼容 MCP 的客户端查询特斯拉车辆信息并执行基本远程操作的用户。官方说明称其为首个同时接入这两个数据源的 MCP 服务器,用户既可以同时使用两者,也可以只配置其中一种。
主要能力
项目共提供 29 个工具,分布在四个类别中。通过 TeslaMate 后端,可进行行车历史、充电记录和车辆状态的深度分析,数据来自 TeslaMate 记录到 Postgres 数据库的信息;通过 Fleet API 后端,可获取实时车辆数据并执行远程命令,例如气候控制、充电管理、门锁与哨兵模式等。安全相关命令如解锁和后备箱操作需要传入 confirm=True 进行确认,并且所有命令均受每天 40 次的频率限制。官方说明还提到 tesla_live 在仅配置令牌的情况下即可工作。
使用方式
用户需要至少配置以下一种后端,官方认为两者都配置最为理想。
TeslaMate 侧:若已运行 TeslaMate,只需提供数据库连接信息;若尚未部署,可参考 TeslaMate 安装指南。TeslaMate 是一个开源的特斯拉数据记录器,将行车、充电和车辆状态记录到 Postgres 数据库。
Fleet API 侧:需要在 developer.tesla.com 注册应用,使用特斯拉的令牌生成流程生成 OAuth 令牌,并搭建 HTTP 代理。命令必须按照特斯拉的 Vehicle Command Protocol 进行签名,需部署该仓库中的 tesla-http-proxy。官方指出,代理仅在执行命令类工具(如 tesla_climate_on、tesla_lock 等)时需要,tesla_live 仅凭令牌即可使用。特斯拉为 Fleet API 提供每月 10 美元的免费额度,官方称这足以满足个人 MCP 使用。
所有配置均通过环境变量完成。接入 Claude Code 时使用 .mcp.json,接入 Claude Desktop 时使用 claude_desktop_config.json,两者结构相同,均在 mcpServers 下添加配置。
车辆配置方面,能耗消耗由理想续航差值估算,相关数值可针对具体车辆调整;这些是默认值,tesla_savings 和 tesla_trip_cost 支持在单次调用时覆盖。
服务器为单文件 Python 实现(约 1400 行),基于 FastMCP 构建,具有两条数据路径。
适用场景
适合已运行 TeslaMate 并希望结合历史分析、或者需要借助 Fleet API 进行实时查询与远程控制的个人用户,尤其适合使用 Claude Code、Claude Desktop、Cursor 等支持 MCP 的客户端进行车辆数据探索与操作。
限制
当前仅支持单车辆,查询使用可配置的 car_id,但工具本身不接受该参数,多车用户需要分别运行服务器实例。输出采用英制单位(英里、华氏度、PSI),公制支持尚在计划中。能耗为估算值,因为 TeslaMate 的 drives 表并不直接包含消耗的能量,估算基于配置的电池容量和理想续航差值,准确率约为 90% 至 95%。命令类工具需要搭建并部署 tesla-http-proxy 并进行请求签名,且受每天 40 次的频率限制,解锁和后备箱等安全命令还需显式确认。
项目受 cobanov/teslamate-mcp 启发,使用 FastMCP 和 TeslaMate 构建。