Tesla MCP Server

Tesla MCP サーバー

Claude を Tesla Owner API に接続するための Model Context Protocol（MCP）サーバーです。Tesla の車両や太陽光発電システムの認証とデータ取得を行うツールを提供します。

必要条件

• Python 3.11
• Model Context Protocol（MCP）Python SDK
• httpx
• python-dotenv

セットアップ

1. uv をインストールする（推奨）

curl -LsSf https://astral.sh/uv/install.sh | sh

2. このリポジトリをクローンする

git clone https://github.com/yourusername/tesla-mcp-server.git
cd tesla-mcp-server

3. 仮想環境を作成して有効化する

# Create virtual environment
uv venv

# Activate virtual environment
# On macOS/Linux:
source .venv/bin/activate
# On Windows:
.venv\Scripts\activate

4. プロジェクトの依存関係を同期する

uv sync

使用方法

認証のセットアップ

このサーバーは Tesla の Owner API を使用し、安全な OAuth2 認証フローを実装しています。Claude Desktop でサーバーを使用する前に、認証セットアップスクリプトを実行する必要があります。

1. 認証セットアップを実行する

重要： Claude でサーバーを使用する前に、このセットアップスクリプトを実行する必要があります。

python setup_auth.py

このスクリプトでは、次の処理が行われます。

• ブラウザーでの認証を求められます
• Tesla の OAuth2 フローが案内されます
• 今後のセッションで使用する refresh_token.txt ファイルが作成されます
• API 接続がテストされ、正常に動作することが確認されます

refresh_token.txt をバージョン管理にコミットしないでください。

2. 認証フローの詳細

• setup_auth.py を初めて実行すると、ブラウザーでの認証を求められます
• ターミナルの指示に従って OAuth2 フローを完了してください
• 認証が成功すると、refresh_token.txt ファイルが作成され、以降のセッションで使用されます
• MCP サーバーは、以降の API 呼び出しでリフレッシュトークンを自動的に使用します

Claude Desktop を設定する

このサーバーを Claude Desktop で使用するには、Claude Desktop の設定に追加する必要があります。

1. tesla_mcp_server ディレクトリで次のコマンドを実行し、Claude Desktop を設定します。

mcp install src/tesla_mcp_server/server.py --name "Tesla" --with-editable .

2. Claude Desktop App の設定ファイル claude_desktop_config.json を開くと、次のようになっています。

{
  "mcpServers": {
    "Tesla": {
      "command": "/Users/<USERNAME>/.cargo/bin/uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with-editable",
        "/path/to/tesla-mcp-server",
        "mcp",
        "run",
        "/path/to/tesla-mcp-server/src/tesla_mcp_server/server.py"
      ],
      "env": {
        "LOG_LEVEL": "INFO"
      }
    }
  }
}

ここで、/path/to/ はお使いのシステム上にある tesla-mcp-server コードフォルダーへのパスです。

3. Claude Desktop を再起動します。

Claude で MCP サーバーを使用する

サーバーが実行され、Claude Desktop の設定が完了したら、次のツールを使用して Tesla のシステムを操作できます。

• tesla_auth_status：Tesla の認証状態を確認します
• get_vehicles：すべての車両の一覧を取得します
• get_vehicle：特定の車両の詳細情報を取得します
• send_command：車両にコマンドを送信します
• get_solar_system：太陽光発電システムの状態を取得します
• get_solar_history：太陽光発電システムの履歴を取得します
• get_system_summary：すべての Tesla システムの概要を取得します

再認証

• 再認証が必要になった場合は、refresh_token.txt を削除し、python setup_auth.py を再度実行してください。

開発とテスト

開発用の依存関係をインストールし、テストスイートを実行するには、次のコマンドを実行します。

uv sync --all-extras
pytest -v tests

サーバーをローカルで実行する

サーバーを手動で起動するには（開発やテストに便利です）、次のコマンドを実行します。

mcp run src/tesla_mcp_server/server.py

ライセンス

GNU General Public License v3.0