MCP-сервер Smartcar

Сервер MCP (Model Context Protocol), который предоставляет API транспортных средств Smartcar в качестве инструментов для ИИ-агентов. Позволяет Claude, ChatGPT и другим MCP-совместимым клиентам запрашивать телеметрию автомобиля и отправлять команды с помощью естественного языка.

Обзор

Этот сервер оборачивает M2M (machine-to-machine) API Smartcar с использованием учетных данных клиента OAuth2. Он автоматически обрабатывает получение и кэширование токенов, поэтому ИИ-агенты взаимодействуют с транспортными средствами без необходимости управления аутентификацией.

16 инструментов в 4 категориях:

Related MCP server: agentforge

Использование

Установка не требуется. Добавьте это в ваш claude_desktop_config.json (или эквивалентный конфиг MCP-клиента):

{
  "mcpServers": {
    "smartcar": {
      "command": "npx",
      "args": ["-y", "smartcar-mcp"],
      "env": {
        "SMARTCAR_CLIENT_ID": "your-client-id",
        "SMARTCAR_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Переменные окружения

Разработка

git clone https://github.com/thachdoSC/smartcar-mcp-test
cd smartcar-mcp
npm install
npm run dev   # run from source
npm run build # compile to dist/

Справочник инструментов

Подключения

list_connections — Список подключений транспортных средств с дополнительными фильтрами.

get_connection — Получить одно подключение по ID.

delete_connection — Удалить подключение по ID.

delete_user — Удалить пользователя и все связанные данные.

Сигналы (Телеметрия)

get_signals — Список всех доступных сигналов для транспортного средства.

get_signal — Получить текущее значение конкретного сигнала.

Зарядка: charge.ischarging, charge.voltage, charge.wattage, charge.amperage, charge.limit, charge.estimation.durationtocompletion, charge.estimation.distance_added, charge.estimation.kwh_added, charge.estimation.percent_added, charge.session.id, charge.session.starttime, charge.session.endtime, charge.session.kwhadded, charge.session.milesadded, charge.session.porttype, charge.session.cost, charge.schedule.type, charge.schedule.starttime, charge.schedule.day, charge.schedule.enabled, charge.porttype, charge.portstatus

Климат: climate.externaltemperature, climate.internaltemperature

Закрытие: closure.door, closure.lock, closure.window, closure.sunroof, closure.fronttrunk, closure.reartrunk, closure.chargeport

Связь: connectivity.firmware, connectivity.isonline, connectivity.sleepstate, connectivity.lastseenat

Диагностика: diagnostics.faultcodes, diagnostics.oil, diagnostics.emissions, diagnostics.abs, diagnostics.airbag, diagnostics.battery.maintenancestatus, diagnostics.battery.range, diagnostics.battery.soc, diagnostics.brakebooster, diagnostics.brakefluid, diagnostics.collision, diagnostics.coolant, diagnostics.cruisecontrol, diagnostics.enginelight, diagnostics.hazardlights, diagnostics.headlights, diagnostics.park, diagnostics.stabilitycontrol, diagnostics.steeringlock, diagnostics.transmission, diagnostics.washerfluid

HVAC: hvac.cabintemperature, hvac.defroster, hvac.heater, hvac.temperatureset, hvac.ventilation

ДВС (Двигатель внутреннего сгорания): ice.fuel.level, ice.fuel.range, ice.fuel.percentremaining, ice.oillife

Местоположение: location.precise, location.ishome

Низковольтная батарея: lowvoltagebattery.stateofcharge, lowvoltagebattery.status

Движение: motion.speed

Одометр: odometer.distance

Сервис: service.isinservice, service.records

Наблюдение: surveillance.brand, surveillance.isenabled

Тяговая батарея: tractionbattery.stateofcharge, tractionbattery.range, tractionbattery.heating, tractionbattery.capacity.kwh, tractionbattery.capacity.usableKwh, tractionbattery.limit, tractionbattery.temperature, tractionbattery.chargecompletiontime, tractionbattery.fullchargetime

Трансмиссия: transmission.drivemode, transmission.gear

ID транспортного средства: vehicleid.vin, vehicleid.color, vehicleid.trim, vehicleid.packages, vehicleid.nickname

Учетная запись пользователя: vehicleuseraccount.grantedpermissions, vehicleuseraccount.role

Колеса: wheel.style, wheel.tires

Команды автомобиля

Все инструменты команд требуют vehicle_id и user_id.

lock_vehicle — Заблокировать двери автомобиля.

unlock_vehicle — Разблокировать двери автомобиля.

start_charge — Начать зарядку электромобиля.

stop_charge — Остановить зарядку электромобиля.

set_charge_limit — Установить максимальный уровень заряда.

set_navigation_destination — Отправить пункт назначения GPS в навигационную систему автомобиля.

Управление

list_applications — Список всех приложений Smartcar в вашей организации.

get_application — Получить детали конкретного приложения по ID.

list_application_secrets — Список учетных данных для приложения (секретные значения не возвращаются).

Структура проекта

src/
├── index.ts          # Server entry point — wires up tools and transport
├── auth.ts           # OAuth2 token manager with in-memory caching
├── client.ts         # HTTP client for Smartcar REST APIs
└── tools/
    ├── connections.ts # Connection and user management tools
    ├── signals.ts     # Vehicle telemetry tools
    ├── commands.ts    # Vehicle control command tools
    └── management.ts  # Application management tools

Аутентификация

Сервер использует учетные данные клиента OAuth2 (поток M2M). Токены кэшируются в памяти и автоматически обновляются за 60 секунд до истечения срока действия. Ручное управление токенами не требуется.