使用说明

项目简介

TezLab MCP服务器是为TezLab应用设计的MCP服务器实现，旨在通过标准化的Model Context Protocol，向大型语言模型（LLM）客户端提供关于特斯拉车辆的丰富数据和实用功能。借助此服务器，LLM应用能够安全、可扩展地获取车辆的充电报告、电池信息、行驶数据、周边超级充电站等上下文信息，从而实现更智能、更个性化的用户体验。

主要功能点

充电报告 (Charge Report): 获取最近充电会话的详细信息，包括充电时长、电量变化、能量使用、成本、环境条件等。
电池信息 (Battery Info): 实时访问车辆信息，如电池电量、充电状态、车辆位置、软件版本、续航里程等。
路程记录 (Road Trips): 获取车辆的历史路程记录，包括行程距离、起止时间、充电站点、驾驶分段等信息。
车辆统计 (Vehicle Stats): 查询车辆的各项统计数据，如能效、平均速度、行驶里程等。
车辆趋势 (Vehicle Trends): 获取车辆的每周驾驶趋势数据，了解每周的行驶距离。
超级充电站 (Superchargers): 检索特斯拉超级充电站列表及详细信息，包括站点位置、状态、评价等。

安装步骤

安装依赖

打开终端，导航至仓库根目录，运行以下命令安装项目依赖：
```
pnpm install
```
构建项目

安装依赖完成后，运行以下命令构建项目：
```
pnpm build
```
构建成功后，将在 'dist' 目录下生成服务器端代码 'mcp-server.js'。

服务器配置

对于需要配置MCP服务器的LLM客户端（如Claude Desktop），您需要提供以下JSON格式的服务器配置信息。请将以下配置添加到您的MCP客户端配置文件中。

{
  "mcpServers": {
    "tezlab": {
      "command": "/path/to/node",  // 请替换为您的Node.js可执行文件路径，例如：/usr/local/bin/node 或使用 which node 命令查询
      "args": ["/path/to/tezlab-cli/dist/mcp-server.js"] // 请替换为 tezlab-cli 项目中 mcp-server.js 文件的绝对路径
    }
  }
}

配置参数说明:

'"tezlab"': 服务器名称，可以自定义，用于在客户端中标识和选择此服务器。
'"command"': Node.js 运行环境的可执行文件路径。请务必替换为您的实际Node.js路径。 您可以使用 'which node' 命令在终端中查找Node.js的安装路径。
'"args"': 启动 'tezlab-mcp-server.js' 脚本所需的参数，这里是 'mcp-server.js' 脚本文件的绝对路径。 请务必替换为您的实际文件路径，确保指向您克隆的 'tezlab-cli' 仓库中构建后的 'mcp-server.js' 文件。

配置示例 (macOS/Linux):

假设您的 Node.js 可执行文件路径为 '/usr/local/bin/node'，'tezlab-cli' 项目克隆在用户目录下的 'The-Focus-AI/tezlab-cli' 文件夹中，则配置可能如下所示：

{
  "mcpServers": {
    "tezlab": {
      "command": "/usr/local/bin/node",
      "args": ["/Users/your_username/The-Focus-AI/tezlab-cli/dist/mcp-server.js"] // 将 your_username 替换为您的用户名
    }
  }
}

请根据您的实际环境和文件路径进行调整。

基本使用方法

启动MCP服务器

MCP服务器将在配置后由MCP客户端自动启动和管理，无需手动启动。当客户端需要与服务器交互时，会自动调用配置的 'command' 和 'args' 启动服务器进程。
通过LLM客户端调用工具

配置并启动TezLab MCP服务器后，您可以在支持MCP协议的LLM客户端中，通过指定工具名称来调用服务器提供的各项功能。

例如，在Claude客户端中，您可以使用如下指令来指示Claude调用 'tezlab' 服务器的 'chargeReport' 工具：
```
@tezlab/chargeReport
```
客户端会将此请求通过MCP协议发送到TezLab MCP服务器，服务器执行 'chargeReport' 工具并返回结果，Claude客户端会将结果呈现给用户。

您可以根据需要调用其他工具，例如：
- 获取电池信息: '@tezlab/batteryInfo'
- 查询路程记录: '@tezlab/roadTrips'
- 获取车辆统计: '@tezlab/vehicleStats'
- 查询车辆趋势: '@tezlab/vehicleTrends'
- 查找超级充电站: '@tezlab/superchargers'
- 获取指定路程记录详情 (需要提供路程ID): '@tezlab/roadTripById id=<路程ID>'
- 获取指定超级充电站详情 (需要提供充电站ID): '@tezlab/superchargerById id=<充电站ID>'
注意： 部分工具可能需要参数，请参考工具的描述信息或仓库文档来了解具体用法。

关键词