Tesla Streamable MCP Server

🚀 Tesla MCP Server

Tessie API を介してテスラ車両を制御するための、ストリーミング可能なHTTP MCPサーバーです。

作者: overment

⚠️ 重要提示

このサーバーをMCPクライアントに接続することは、あなた自身の責任で行ってください。言語モデルは誤りを犯したり、指示を誤解したり、意図しないアクションを実行する可能性があります。特に、車の解錠、トランクの開放、ナビゲーション先の送信などのアクションについては、実行前に必ずコマンドを確認してください。

HTTPレイヤーは開発時の利便性を目的として設計されており、本番環境でのセキュリティを保証するものではありません。リモートでデプロイする場合は、適切なトークン検証、安全な保存、TLS終端、厳格なCORS/オリジンチェック、レート制限、および監査ログの設定など、セキュリティ対策を強化してください。

🚀 クイックスタート

このリポジトリは、以下の2つの方法で動作します。

• ローカルワークフロー用の Node/Honoサーバー として
• リモートインタラクション用の Cloudflare Worker として

✨ 主な機能

• ✅ 状態 — バッテリー、航続距離、位置、クライメート、ドア、充電状態
• ✅ コマンド — 施錠/解錠、クライメート制御、トランクの開閉、セントリーモード、ナビゲーション
• ✅ 位置認識 — コンテキスト認識型インタラクションのためのGPS座標
• ✅ デュアルランタイム — Node.js/BunまたはCloudflare Workers

設計原則

• LLMフレンドリー：1対1のAPIミラーではなく、2つの統一されたツール
• ウォッチ対応：位置コンテキストを持つAIエージェント向けに設計
• セキュア：Tessie APIキーはシークレットとして保存され、クライアントは個別のベアラートークンを使用
• 明確なフィードバック：詳細なコマンド結果と車両状態

📦 インストール

前提条件: Bun、Tessieアカウント。

実行方法 (いずれか1つを選択)

1. ローカル開発 — ベアラートークン認証による標準セットアップ
2. Cloudflare Worker (wrangler dev) — ローカルでのWorkerテスト
3. Cloudflare Worker (deploy) — リモート本番環境

1. ローカル開発 — クイックスタート

1. Tessieの資格情報を取得します。

   • developer.tessie.com にアクセスします。
   • Developer Settings → Generate Access Token に移動します。
   • アクセストークンをコピーします。
   • 車両のVINをメモします。

2. 環境を設定します。

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

.env を編集します。

PORT=3000
AUTH_ENABLED=true
AUTH_STRATEGY=bearer

# Generate with: openssl rand -hex 32
BEARER_TOKEN=your-random-auth-token

# Tessie credentials
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

出力には以下のような内容が表示されます。

Add the following to your wrangler.toml:
[[kv_namespaces]]
binding = "TOKENS"
id = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

2. wrangler.toml をKV名前空間IDで更新します。

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

3. シークレットを設定します。

# Generate a random token for client authentication
openssl rand -hex 32
bun x wrangler secret put BEARER_TOKEN
# Paste the generated token when prompted

# Tessie API credentials
bun x wrangler secret put TESSIE_ACCESS_TOKEN
# Paste your Tessie token when prompted

bun x wrangler secret put TESSIE_VIN
# Paste your VIN when prompted

4. デプロイします。

bun x wrangler deploy

エンドポイント: https://<worker-name>.<account>.workers.dev/mcp

💻 使用例

クライアント設定

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
# Connect to: http://localhost:3000/mcp (local) or https://your-worker.workers.dev/mcp (remote)

ツール

tesla_state

テスラ車両の現在の状態を取得します。

// Input
{}

// Output
{
  display_name: string;           // 車両名
  battery_level: number;          // 0-100%
  battery_range_km: number;       // 推定航続距離 (km)
  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;         // km/h または駐車中は 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 = open
    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

テスラ車両にコマンドを実行します。

// Input
{
  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")
}

// Output
{
  success: boolean;
  command: string;
  message: string;
}

コマンドリファレンス:

具体的な使用例

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 App, Claude Desktop)                      │
│      │                                                          │
│      │ Authorization: Bearer <BEARER_TOKEN>                     │
│      ▼                                                          │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │  Cloudflare Worker / Node.js Server                      │   │
│  │                                                          │   │
│  │  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      # コードのリント
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