特斯拉车辆控制协议服务器

Tessie MCP Server是一个模型上下文协议服务器,通过封装Tessie API,使LLM客户端能够通过高效、专注的API端点查询和控制配置的特斯拉车辆。

  • by EzeLLM
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 EzeLLM/tessie_mcp

使用说明

Tessie MCP服务器

一个模型上下文协议(MCP)服务器,它封装了Tessie API,因此LLM客户端(Cursor、Claude等)可以使用高效、集中的API端点查询和控制配置的Tesla。

状态

  • 遥测: 完全实现了传统(完整状态)和新的专用端点,以实现高效的数据检索。
  • 控制: honk_horn 和 flash_lights 是活的和功能性的。锁定/解锁和气候控制都是脚手架。
  • 突破性变化: 现在使用VIN而不是车牌进行车辆识别。
  • 在第一个稳定标签被剪切之前,可能会发生重大变化。

快速开始

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt

# Configure environment
cp .env.example .env

编辑 .env 并设置您的Tessie API代币和车辆VIN:

TESSIE_TOKEN=your_tessie_api_token_here
VEHICLE_VIN=5YJ3E1EA1KF123456  # Your Tesla VIN
TELEMETRY_INTERVAL=5           # minutes; use 'realtime' to skip caching

运行服务器(默认为STDIO):

python -m src.server

远程/SSE模式(适用于网络客户端):

python -m src.server --transport sse --host 0.0.0.0 --port 8000

期待什么

  • 新的专用遥测端点: 高效、专注的API要求电池、电池健康状况、位置、轮胎压力和车辆状态。
  • 传统遥测工具: 完整的车辆状态获取,所有传统指标仍然可用。
  • 工作控制措施: honk_horn 和 flash_lights 在特斯拉上执行真实的命令。
  • Tessie支持的身份验证和缓存;遵守刷新间隔 .env.
  • 基于VIN的车辆识别,以提高可靠性。

回购布局

  • src/server.py --MCP入口点;加载遥测+控制工具,处理VIN配置。
  • src/telemetry/service.py --使用缓存和专用端点方法进行遥测检索。
  • src/telemetry/tools.py --遥测工具注册表/调度(新工具+旧工具)。
  • src/control/service.py --通过真实的鸣笛/闪光实现控制动作。
  • src/control/tools.py --控制工具注册表/调度。
  • src/tessie_client.py --Tessie REST客户端,具有基于VIN的遥测和控制端点。

可用工具

新型专用遥测技术(推荐)

  • get_battery_information --电池电量、电量、能量、电压、电流、温度
  • get_battery_health_information --电池容量和最大续航里程
  • get_location_information --带地址的GPS坐标
  • get_tire_pressure_information --所有轮胎压力及其状态
  • get_vehicle_status --睡眠/唤醒状态

控制(实时)

  • honk_horn --按响车辆喇叭(⚠️ 实际行动)
  • flash_lights --闪烁车灯(⚠️ 实际行动)

路线图

  • 完全锁定/解锁车门控制
  • 实施气候控制(启动/停止)
  • 添加充电控制
  • 行李箱/行李箱控制

看 代理商.md 获取完整的工具文档。