Tesla MCP Server

Tesla MCP 服务

用于将 Claude 连接到 Tesla Owner API 的模型上下文协议（MCP）服务。它提供用于对 Tesla 车辆和太阳能系统进行身份验证和数据检索的工具。

要求

• Python 3.11
• 模型上下文协议（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 文件，供后续会话使用
• 后续 API 调用时，MCP 服务将自动使用刷新令牌

配置 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 通用公共许可证 v3.0