Tesla Streamable MCP Server

🚀 Tesla MCP Server

Tesla MCP Server 是一个可流式传输的 HTTP MCP 服务器，借助 Tessie API 实现对特斯拉车辆的控制。

作者：overment

⚠️ 重要提示

你需自行承担将此服务器连接到 MCP 客户端的责任。语言模型可能会出错、误解指令或执行意外操作。在执行命令之前，请务必进行验证，特别是对于解锁、打开后备箱或发送导航目的地等操作。

HTTP 层是为开发过程中的便利性而设计的，并非具备生产级别的安全性。如果要进行远程部署，请加强安全措施，包括进行适当的令牌验证、安全存储、TLS 终止、严格的 CORS/源检查、速率限制和审计日志记录。

🚀 快速开始

本项目有两种运行方式：

• 作为 Node/Hono 服务器，适用于本地工作流程。
• 作为 Cloudflare Worker，用于远程交互。

✨ 主要特性

• ✅ 状态监测 — 可获取电池电量、续航里程、车辆位置、车内气候、车门状态和充电状态等信息。
• ✅ 指令控制 — 支持锁定/解锁车辆、调节车内气候、控制后备箱、开启哨兵模式和设置导航等指令。
• ✅ 位置感知 — 提供 GPS 坐标，实现基于位置的交互。
• ✅ 双运行环境 — 支持在 Node.js/Bun 或 Cloudflare Workers 环境中运行。

设计原则

• 对大语言模型友好：提供两个统一的工具，而非 1:1 的 API 镜像。
• 便于监控：专为具有位置上下文的 AI 代理设计。
• 安全可靠：Tessie API 密钥以秘密方式存储，客户端使用单独的承载令牌进行身份验证。
• 反馈清晰：提供详细的指令执行结果和车辆状态信息。

📦 安装指南

前提条件

• Bun
• Tessie 账户

运行方式（任选其一）

1. 本地开发 — 使用承载令牌认证的标准设置。
2. Cloudflare Worker（本地开发） — 在本地进行 Worker 测试。
3. Cloudflare Worker（部署到生产环境） — 用于远程生产环境。

1. 本地开发 — 快速开始

1. 获取 Tessie 凭证：
   • 访问 developer.tessie.com。
   • 进入 开发者设置 → 生成访问令牌。
   • 复制你的访问令牌。
   • 记录你的车辆 VIN 码。
2. 配置环境：

cd tesla-mcp
bun install
cp .env.example .env

编辑 .env 文件：

PORT=3000
AUTH_ENABLED=true
AUTH_STRATEGY=bearer

# 使用以下命令生成：openssl rand -hex 32
BEARER_TOKEN=your-random-auth-token

# Tessie 凭证
TESSIE_ACCESS_TOKEN=your-tessie-access-token
TESSIE_VIN=your-vehicle-vin

3. 运行：

bun dev
# MCP: http://127.0.0.1:3000/mcp

Claude Desktop / Cursor 配置：

{
  "mcpServers": {
    "tesla": {
      "command": "npx",
      "args": ["mcp-remote", "http://localhost:3000/mcp", "--transport", "http-only"],
      "env": { "NO_PROXY": "127.0.0.1,localhost" }
    }
  }
}

2. Cloudflare Worker（本地开发）

bun x wrangler dev --local | cat

创建 .dev.vars 文件存储本地机密信息：

BEARER_TOKEN=your_random_auth_token
TESSIE_ACCESS_TOKEN=your_tessie_token
TESSIE_VIN=your_vehicle_vin

端点地址：http://127.0.0.1:8787/mcp

3. Cloudflare Worker（部署到生产环境）

1. 创建用于会话存储的 KV 命名空间：

bun x wrangler kv:namespace create TOKENS

输出结果会显示：

将以下内容添加到你的 wrangler.toml 文件中：
[[kv_namespaces]]
binding = "TOKENS"
id = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

2. 使用你的 KV 命名空间 ID 更新 wrangler.toml 文件：

[[kv_namespaces]]
binding = "TOKENS"
id = "your-kv-namespace-id-from-step-1"

3. 设置机密信息：

# 生成用于客户端认证的随机令牌
openssl rand -hex 32
bun x wrangler secret put BEARER_TOKEN
# 提示时粘贴生成的令牌

# Tessie API 凭证
bun x wrangler secret put TESSIE_ACCESS_TOKEN
# 提示时粘贴你的 Tessie 令牌

bun x wrangler secret put TESSIE_VIN
# 提示时粘贴你的 VIN 码

4. 部署：

bun x wrangler deploy

端点地址：https://<worker-name>.<account>.workers.dev/mcp

💻 使用示例

1. 获取车辆状态

{
  "name": "tesla_state",
  "arguments": {}
}

2. 锁定车辆

{
  "name": "tesla_command",
  "arguments": {
    "command": "lock"
  }
}

3. 将温度设置为 22°C

{
  "name": "tesla_command",
  "arguments": {
    "command": "set_temperature",
    "temperature": 22
  }
}

4. 在出发前开启车内气候控制

{
  "name": "tesla_command",
  "arguments": {
    "command": "start_climate"
  }
}

5. 导航到目的地

{
  "name": "tesla_command",
  "arguments": {
    "command": "share",
    "destination": "Golden Gate Bridge, San Francisco"
  }
}

📚 详细文档

客户端配置

Alice 应用

添加为 MCP 服务器，配置如下：

• URL：https://your-worker.workers.dev/mcp
• 类型：streamable-http
• 请求头：Authorization: Bearer <your-BEARER_TOKEN>

Claude Desktop / Cursor（本地服务器）

{
  "mcpServers": {
    "tesla": {
      "command": "npx",
      "args": ["mcp-remote", "http://127.0.0.1:3000/mcp", "--transport", "http-only"],
      "env": { "NO_PROXY": "127.0.0.1,localhost" }
    }
  }
}

Claude Desktop / Cursor（Cloudflare Worker）

{
  "mcpServers": {
    "tesla": {
      "command": "npx",
      "args": ["mcp-remote", "https://your-worker.workers.dev/mcp", "--transport", "http-only"]
    }
  }
}

MCP 检查器（快速测试）

bunx @modelcontextprotocol/inspector
# 连接到：http://localhost:3000/mcp（本地）或 https://your-worker.workers.dev/mcp（远程）

工具说明

tesla_state

获取特斯拉车辆的当前状态。

// 输入
{}

// 输出
{
  display_name: string;           // 车辆名称
  battery_level: number;          // 电池电量百分比（0 - 100%）
  battery_range_km: number;       // 估计续航里程（公里）
  charging: {
    state: string;                // 充电状态（"Disconnected", "Charging", "Complete", "Stopped"）
    minutes_remaining: number | null;
    charge_limit: number;         // 充电限制百分比
  };
  location: {
    latitude: number;
    longitude: number;
    heading: number;              // 行驶方向（0 - 359°）
    speed: number | null;         // 车速（公里/小时），停车时为 null
  };
  locked: boolean;
  sentry_mode: boolean;
  climate: {
    is_on: boolean;
    inside_temp: number;          // 车内温度（°C）
    outside_temp: number;         // 车外温度（°C）
    target_temp: number;          // 目标温度（°C）
    is_defrosting: boolean;
  };
  doors: {
    front_left: boolean;          // 左前门状态（true = 打开）
    front_right: boolean;
    rear_left: boolean;
    rear_right: boolean;
    frunk: boolean;
    trunk: boolean;
    charge_port: boolean;
  };
  state: "online" | "asleep" | "offline";
  odometer_km: number;
  last_updated: string;           // ISO 8601 格式的最后更新时间
}

tesla_command

在特斯拉车辆上执行指令。

// 输入
{
  command: "lock" | "unlock" | "start_climate" | "stop_climate" |
           "set_temperature" | "start_defrost" | "stop_defrost" |
           "open_frunk" | "open_trunk" | "open_charge_port" |
           "close_charge_port" | "enable_sentry" | "disable_sentry" |
           "flash" | "honk" | "share";
  temperature?: number;           // set_temperature 指令所需参数（15 - 28°C）
  destination?: string;           // share 指令所需参数
  locale?: string;                // share 指令可选参数（例如，"en-US"）
}

// 输出
{
  success: boolean;
  command: string;
  message: string;
}

指令参考：

认证流程

┌─────────────────────────────────────────────────────────────────┐
│  客户端（Alice 应用、Claude Desktop）                           │
│      │                                                          │
│      │ Authorization: Bearer <BEARER_TOKEN>                     │
│      ▼                                                          │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │  Cloudflare Worker / Node.js 服务器                      │   │
│  │                                                          │   │
│  │  1. 验证 BEARER_TOKEN（客户端认证）                      │   │
│  │  2. 使用 TESSIE_ACCESS_TOKEN（内部 API 密钥）            │   │
│  │                                                          │   │
│  │  env.TESSIE_ACCESS_TOKEN ──┐                             │   │
│  │  env.TESSIE_VIN ───────────┼──► TessieClient             │   │
│  │                            │         │                   │   │
│  │                            │         ▼                   │   │
│  │                            │   api.tessie.com            │   │
│  └─────────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────────┘

关键点：

• BEARER_TOKEN：你生成的随机令牌，用于客户端向 MCP 服务器进行身份验证。
• TESSIE_ACCESS_TOKEN：你的 Tessie API 密钥，由服务器内部使用。
• 客户端永远不会看到你的 Tessie 凭证。

HTTP 端点

开发命令

bun dev           # 开启热重载模式启动
bun run typecheck # 进行 TypeScript 检查
bun run lint      # 代码 lint 检查
bun run build     # 生产环境构建
bun start         # 运行生产环境版本

项目架构

src/
├── shared/
│   └── tools/
│       ├── tesla-state.ts      # 获取车辆状态
│       └── tesla-command.ts    # 执行指令
├── services/
│   └── tessie.service.ts       # Tessie API 客户端
├── schemas/
│   ├── commands.ts             # 指令定义
│   ├── outputs.ts              # 工具输出模式
│   └── tessie.ts               # Tessie API 响应模式
├── config/
│   └── metadata.ts             # 服务器和工具描述
├── index.ts                    # Node.js 入口文件
└── worker.ts                   # Workers 入口文件

环境变量

Node.js（.env）

Cloudflare Workers（wrangler.toml + 机密信息）

wrangler.toml 变量：

AUTH_ENABLED = "true"
AUTH_STRATEGY = "bearer"

机密信息（通过 wrangler secret put 设置）：

• BEARER_TOKEN — 客户端随机认证令牌
• TESSIE_ACCESS_TOKEN — Tessie API 访问令牌
• TESSIE_VIN — 你的车辆 VIN 码

KV 命名空间：

[[kv_namespaces]]
binding = "TOKENS"
id = "your-kv-namespace-id"

故障排除

调试方法

使用 MCP 检查器进行测试：

bunx @modelcontextprotocol/inspector
# 连接到你的端点并测试工具

查看 Worker 日志：

wrangler tail

📄 许可证

本项目采用 MIT 许可证。