特斯拉MCP服务器:https://mcp.myteslamate.com/mcp
此存储库提供 模型上下文协议 服务器,用于包装特斯拉车队API和TeslaMate API。它包括车辆端点、车辆命令、能源端点(Powerwall/Solar)和充电端点。该实现是模块化的,功能齐全 98个MCP工具 对于特斯拉车队API和 9个MCP工具 用于TeslaMate API。
______________________________________________________________________
✨ 你能做什么
这不仅仅是远程控制,它是整个特斯拉生态系统的对话界面。 直接向您的AI表达您的用例 --用通俗易懂的语言描述你想要什么,让它弄清楚要调用哪些工具,以什么顺序,用什么参数。没有要打开的应用程序,也没有要导航的菜单。
⚡ 能量优化
*“我的Powerwall是40%。我应该现在给车充电,还是等到今天下午太阳能发电?”*
*“分析我过去30天的能源数据——我在晚上付费的同时向电网出口是否会亏损?”*
*“将Powerwall备用储备设置为20%,并安排汽车在凌晨2点至6点16A充电。”*
人工智能可以交叉参考您的太阳能产量、Powerwall状态、电网费率和车辆电池电量,为您提供建议,并立即采取行动。
🚗 智能车辆管理
*“我下周四有一次去里昂的公路旅行。根据我平时的效率,我需要停下来充电吗?在路上找到最好的增压器。”*
*“比较一下我这个月和上个月的能耗。有什么变化?”*
*“每个工作日早上7:45对汽车进行预处理,并将充电限制重新设置为80%——目前从旅行开始,充电限制为100%。”*
📊 数据与见解(使用TeslaMate API)
*“过去3个月我的平均公里/千瓦时是多少?情况是否越来越糟?”*
*“给我看看我今年最昂贵的充电时间以及它们发生在哪里。”*
*“汽车每周在气候条件下行驶多少小时?能源成本是多少?”*
🔐 安全与安心
*“我的车锁了吗?哨兵模式打开了吗?我忘了在登机前检查。”*
*“我的车停在市中心。打开哨兵模式,把当前位置发给我。”*
______________________________________________________________________
🎨 生成式UI——按需定制仪表板
除了预构建的小部件,服务器还公开了 生成式用户界面 因此,人工智能可以动态构建交互式预制UI组件,用图表、表格和度量卡来回答问题,而不仅仅是文本。
*“给我一张上个月每个地点的收费柱状图。”*
*“为这款车构建一个仪表板:当前SoC、最近7次驱动和电池健康状况下降。”*
*“用两张并排的度量卡比较我今年冬天和去年夏天的效率。”*
AI使用 generative_generate_prefab_ui 在沙盒中编写Python代码(服务器上的Pyodide+Deno);生成的小部件通过Skybridge mime iframe直接呈现在您的聊天中——您无需编写模板,也无需额外的往返。同伴 generative_search_prefab_components 查找工具使LLM对组件签名保持诚实。
它同样适用于特斯拉车队API和TeslaMate用户-相同的生成工具由任一订阅提供。
技能——预框架分析工作流程
服务器也发货 MCP技能:markdown工作流——LLM按需读取——将工具链接成连贯的答案。第一个可用的是 drive-efficiency-coach:
*“运行过去30天的驾驶效率教练,并将其显示为报告。”*
该技能引导AI获取您的TeslaMate驱动器,计算Wh/km百分位数,识别异常值,交叉引用速度/温度/行程长度,并呈现生成UI报告(度量卡+异常值表+1-3个基于您自己的数字的可操作指导见解)。
🤝 贡献一项技能
技能是在不接触Python的情况下扩展此服务器的最简单方法。 欢迎拉取请求 --在下面放置一个新目录 tesla_mcp/skills/ 和 SkillsDirectoryProvider 自动拾取它。
一个好的技能是:
- 特定的 --很好地回答一个具体问题,而不是试图做所有事情(例如。 *“按地点汇总一段时间的收费成本”* 节拍 *“管理我的收费”*).
- 工具感知 --指定要调用的确切MCP工具(
teslamate_get_car_drives,energy_live_status,…)和正确的论点。 - 数字锚定 --指导/见解步骤引用了从用户自己的数据中得出的数字,而不是通用的陈词滥调。
- 视觉效果有帮助 --以a结尾
generative_generate_prefab_ui提供分析/报告;一次性问题的纯文本。 - 坦诚面对陷阱 --指出LLM应该处理的单元歧义、数据差距和边缘情况。
最小布局:
tesla_mcp/skills/your-skill-name/
└── SKILL.mdSKILL.md 从YAML frontmatter开始(name, description)随后是工作流程。看 drive-efficiency-coach/SKILL.md 作为参考。
等待作者的想法:
charging-cost-breakdown--集团上个月按地点、路面成本(每100公里)收取的费用weekly-tesla-digest--驱动器+充电+电池快照+软件更新,作为周一上午的电子邮件式报告range-anxiety-checker--给定目的地、交叉参考SoC、天气、海拔高度和最近的效率,以停止或安抚home-charging-window-finder--使用TOU设置+最近的充电时段,找到今晚最便宜的4小时窗口
______________________________________________________________________
可用功能 (特斯拉车队API的98个工具+特斯拉API的9个工具+2个Generative UI工具+技能):
- 车辆控制:锁定/解锁、空调、行李箱、车窗、车灯、喇叭
- 充电:启动/停止、设置限制、时间表、充电电流、充电历史
- Powerwall和太阳能:实时状态、能源历史、备用储备、风暴模式、电网导入/导出、使用时间设置
- 导航:发送目的地,查找附近的增压器
- 安全:哨兵模式、代客泊车模式、限速、驾驶密码
- 数据和分析:车辆数据、行程历史、驾驶统计 *(TeslaMate API)*
- 生成式用户界面:由AI在沙盒Pyodide运行时中编写的按需预制仪表板(图表、指标、表格)
- 技能:预先构建的分析工作流程(例如。
drive-efficiency-coach)人工智能按需读取,将工具链接成连贯的答案
🔐 一键SSO——连接您的特斯拉账户
托管服务器支持 OAuth 2.0单点登录 通过特斯拉的官方授权服务器。兼容的客户端(ChatGPT、Claude.ai、VS Code…)触发自动登录流-- 不需要令牌复制粘贴.
MCP server URL: https://mcp.myteslamate.com/mcp服务器将OAuth流代理到 auth.tesla.com,然后透明地将您的特斯拉代币兑换为MyTeslaMate代币。你的特斯拉证书永远不会接触到这台服务器。______________________________________________________________________
🤖 ChatGPT(应用程序/MCP连接器)上的设置
ChatGPT通过以下方式支持本机MCP连接器 设置→ Apps.
- 在 chat.openai.com,打开 设置 → 应用.
- 点击 创建应用程序.
- 输入MCP服务器URL:
https://mcp.myteslamate.com/mcp- ChatGPT将自动发现OAuth元数据并提示您 连接.
- 使用您的特斯拉帐户登录-授权将自动处理。
- 连接器出现在您的 已启用的应用程序 列表,可在您的所有聊天中使用。
______________________________________________________________________
🧠 Claude.ai(MCP连接器)上的设置
- 打开 claude.ai → 设置 → 连接器.
- 点击 添加自定义连接器.
- 输入名称(例如。
Tesla)以及MCP服务器URL:
https://mcp.myteslamate.com/mcp- 点击 添加 --Claude将自动发现OAuth元数据并显示 连接 按钮。
- 点击 连接 --您将被重定向到特斯拉的登录页面。
- 授权后,克劳德将有权访问所有特斯拉MCP工具。
注: 基于OAuth的SSO需要MyTeslaMate帐户。服务器会验证您的Tesla令牌,并自动将其链接到您的MTM订阅。
______________________________________________________________________
🤖 Claude代码技能
此MCP服务器的现成克劳德代码技能可在 myteslamate/tesla技能.
安装 /tesla 斜线命令一步到位:
然后在克劳德代码中:
/tesla what is my battery level?
/tesla lock my car
/tesla how much did I charge last month?______________________________________________________________________
🚀 快速入门-直接在VS Code、Claude Desktop等中使用。
无需安装! 直接使用托管的MCP服务器。两种身份验证选项:
选项A-SSO(建议用于Claude.ai和ChatGPT)
只需提供服务器URL,让客户端自动处理OAuth流(见上文)。
选项B——手动令牌(VS代码、光标、克劳德桌面)
对于不支持OAuth的客户端,请直接在 Authorization 头球
用于VS代码/游标(带MCP扩展)和其他MCP客户端
将两个端点添加到您的 .vscode/mcp.json 配置以选择您的首选集成:
{
"servers": {
"tesla": {
"type": "http",
"url": "https://mcp.myteslamate.com/mcp"
}
}
}- 使用
tesla_fleet_api以便直接访问特斯拉的官方车队API。 - 使用
teslamate通过TeslaMate API进行集成。
适用于克劳德桌面
在MCP连接器配置中添加具有与上述相同URL和标头的端点。:
claude mcp add --transport http tesla-api "https://mcp.myteslamate.com/mcp"根据您的身份验证方法和API首选项选择服务器。
🔑 获取令牌(仅手动模式)
- 访问 MyTeslaMate.com
- 使用您的特斯拉帐户登录
- 导航到仪表板中的API部分
- 复制您的个人API令牌
- 在MCP配置中使用它
🔧 自助主机(高级)
如果您更喜欢运行自己的实例,此存储库还支持TeslaMate API和Tesla Fleet API(需要特斯拉开发者帐户和正确的Fleet API注册)。
特性
- 模块化包装
tesla_mcp可重复使用TeslaClient. - 车辆端点 (29个只读端点):
- 核心车辆信息: - GET /api/1/vehicles -列出车辆 - GET /api/1/vehicles/{vehicle_tag} -获取车辆元数据 - GET /api/1/vehicles/{vehicle_tag}/vehicle_data -获取实时车辆数据 - POST /api/1/vehicles/{vehicle_tag}/wake_up -唤醒休眠车辆 - POST /api/1/vehicles/fleet_status -车队状态 - GET /api/1/vehicles/{vehicle_tag}/mobile_enabled -检查移动访问 - GET /api/1/vehicles/{vehicle_tag}/nearby_charging_sites -附近充电 - GET /api/1/vehicles/{vehicle_tag}/service_data -服务数据 - GET /api/1/vehicles/{vehicle_tag}/release_notes -固件发行说明 - GET /api/1/vehicles/{vehicle_tag}/recent_alerts -最近的警报 - GET /api/1/dx/vehicles/options?vin={vin} -车辆选项 - GET /api/1/dx/vehicles/upgrades/eligibility?vin={vin} -符合条件的升级 - GET /api/1/dx/vehicles/subscriptions/eligibility?vin={vin} -符合条件的订阅 - 驱动程序和共享 (6个端点): - GET /api/1/vehicles/{vehicle_tag}/drivers -列出允许的驾驶员(仅限车主) - DELETE /api/1/vehicles/{vehicle_tag}/drivers -删除驾驶员访问权限 - GET /api/1/vehicles/{vehicle_tag}/invitations -列出活动共享邀请(分页) - POST /api/1/vehicles/{vehicle_tag}/invitations -创建共享邀请(24小时到期,一次性使用) - POST /api/1/invitations/redeem -兑换分享邀请 - POST /api/1/vehicles/{vehicle_tag}/invitations/{id}/revoke -取消共享邀请 - 舰队遥测 (4个端点): - GET /api/1/vehicles/{vehicle_tag}/fleet_telemetry_config -获取车队遥测配置 - POST /api/1/vehicles/fleet_telemetry_config -配置自托管车队遥测服务器 - DELETE /api/1/vehicles/{vehicle_tag}/fleet_telemetry_config -删除车队遥测配置 - GET /api/1/vehicles/{vehicle_tag}/fleet_telemetry_errors -最近的舰队遥测错误 - 推送通知订阅 (4个端点): - GET /api/1/subscriptions -获取移动设备的订阅 - POST /api/1/subscriptions -为移动设备设置订阅 - GET /api/1/vehicle_subscriptions -获取车辆订阅 - POST /api/1/vehicle_subscriptions -设置车辆订阅 - 保修和签名命令 (2个端点): - GET /api/1/dx/warranty/details?vin={vin} -获取保修信息 - POST /api/1/vehicles/{vehicle_tag}/signed_command -执行签名命令(特斯拉车辆指挥协议)
- 车辆指令 (64个控制端点):
- 门和通道:门锁、门锁、启动行李箱 - 气候:自动调节启动/停止、设置温度、设置气候保持器模式、设置生物武器模式、设置舱室过热保护、设置气候温度、设置调节max - 座椅和转向:remote_seat_heater_request、remote_seat_coiler_request、remote_auto_seat_climate-request、remote_steering_wheel_heater_request,remote_steeling_wheel_level_request,远程_auto_steering-wheel_heat_climate_request - 充电:charge_start、charge_stop、charge_port_door_open/close、set_charge_limit、charge_standard、charge_max_range、set_charging_amps、set_scheduled_charging、add/remove_charge_schedule、add/remote_condition_schedule - 窗户和天窗:windows_control、sun_roof_control - 灯光和喇叭:闪光灯、喇叭 - 媒体:adjust_volume、media_toggle_playback、media_next/prev_track、media_next/prev_fav、media_volume_down - 导航:navigation_request、navigation_gps_request、导航_sc_request - 安全:set_sentry_mode、set_valet_mode、reset_valet_pin、speed_limit_set_limit、speed_limit激活/停用/clear_pin、speed-limit_clear_pin_admin、set_pin_to_drive、reset_pin_ti_drive_pin、clear_pin_t0_drive_admin - 软件:计划软件更新,取消软件更新 - 杂项:remote_start_drive、trigger_homelink、remote_boombox、set_vehicle_name、guest_mode、erase_user_data
- 能源端点 (Powerwall/Solar控制的12个端点):
- 信息:energy_products(列出所有产品)、energy_site_info(站点配置)、energy-live_status(实时功率/能量数据) - 历史:energy_history(随时间变化的能量测量)、energy_backup_history(离网事件)、energe_charge历史(墙壁连接器使用情况) - 控制:energy_operation(设置模式:自主/自耗)、energy_backup(设置备用储备%)、energy.off_grid_vehicle_charging_reserve(停电期间电动汽车充电的储备) - 网格设置:energy_storm_mode(启用/禁用风暴监视)、energy_grid_import_export(控制电网充电/导出)、energy_time_of_use_settings(配置公用事业费率计划)
- 充电端点 (收费历史和发票的3个端点):
- charging_history(带过滤器的分页充电历史) - charging_invoice(下载收费活动的PDF发票) - charging_sessions(包含定价和能源数据的会话信息-仅限企业账户)
- 集中错误处理和基本日志记录,使MCP客户端显得有用
诊断。
配置
API端点配置
使用 TESLA_BASE_URL 环境变量:
对于MyTeslaMate API(默认)
# No configuration needed - uses default
# Or explicitly set:
export TESLA_BASE_URL=https://api.myteslamate.com对于特斯拉车队API(官方)
选择您的区域端点:
# North America, Asia-Pacific (excluding China)
export TESLA_BASE_URL=https://fleet-api.prd.na.vn.cloud.tesla.com
# Europe, Middle East, Africa
export TESLA_BASE_URL=https://fleet-api.prd.eu.vn.cloud.tesla.com
# China
export TESLA_BASE_URL=https://fleet-api.prd.cn.vn.cloud.tesla.cn备注:使用官方特斯拉车队API时,请确保您具备:
- 注册的特斯拉开发者账户
- 正确的车队API访问权限
- 有效的OAuth 2.0承载令牌
安装
安装Python依赖项一次:
pip install -r requirements.txt运行MCP服务器
您可以通过多种方式启动服务器:
选项1:使用uvicorn(推荐)
uvicorn tesla_mcp.app:app --host 0.0.0.0 --port 8000 --reload选项2:Docker组合方法
make up选项3:传统方法
python server.py服务器将在以下时间开始使用HTTP流 http://0.0.0.0:8084.连接兼容MCP的设备 客户端(如带有MCP扩展的Cursor或VS Code)并配置服务器 指向此端点的条目。
用法示例
MyTeslaMate快速入门
# 1. Start the server (uses MyTeslaMate API by default)
uvicorn tesla_mcp.app:app --host 0.0.0.0 --port 8000
# 2. Configure your MCP client with:
# URL: http://localhost:8000/sse
# Authorization: Bearer YOUR_MYTESLAMATE_TOKEN使用特斯拉车队API(官方)
# 1. Set your regional endpoint
export TESLA_BASE_URL=https://fleet-api.prd.na.vn.cloud.tesla.com
# 2. Start the server
uvicorn tesla_mcp.app:app --host 0.0.0.0 --port 8000
# 3. Configure your MCP client with:
# URL: http://localhost:8000/sse
# Authorization: Bearer YOUR_TESLA_FLEET_TOKENDocker使用
# Build the image
docker build -t tesla-mcp .
# Run with MyTeslaMate (default)
docker run -p 8000:8000 tesla-mcp
# Run with Tesla Fleet API
docker run -p 8000:8000 -e TESLA_BASE_URL=https://fleet-api.prd.na.vn.cloud.tesla.com tesla-mcp添加新模块
- 在以下位置创建文件
tesla_mcp/modules/继承自TeslaModule. - 在中注册模块
tesla_mcp/modules/__init__.py. - 展示内部的新MCP工具
server.py将其委托给模块方法。
这种结构使MCP层保持较薄,同时集中所有特斯拉车队API 和中的TeslaMate API逻辑 tesla_mcp 包裹。
