MCP-сервер Bouncie

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

Что он делает

Подключите свой GPS-трекер Bouncie к ИИ. Задавайте вопросы на естественном языке, например:

• "Где сейчас моя машина?"

• "Покажи мои поездки за прошлую неделю"

• "Горит ли индикатор Check Engine? Какие коды ошибок?"

• "Сколько топлива у меня осталось?"

• "Какая поездка была самой длинной на этой неделе?"

Related MCP server: Unoffical Polestar 2 MCP

Функции

• Отслеживание автомобиля в реальном времени — GPS-координаты, скорость, направление, адрес

• История поездок и аналитика — расстояние, длительность, средняя/максимальная скорость, расход топлива, количество случаев резкого торможения и ускорения, GPS-треки (полилиния или GeoJSON)

• Диагностика автомобиля — статус индикатора Check Engine (MIL), диагностические коды неисправностей OBD2 (DTC), состояние аккумулятора

• Информация об автомобиле — марка, модель, год выпуска, VIN, двигатель, одометр, уровень топлива

• Многопользовательский OAuth — HTTP-режим проксирует OAuth от Claude.ai к Bouncie, поэтому каждый пользователь авторизуется через свою учетную запись Bouncie

• Режимы Stdio + HTTP — запуск локально с предварительно полученным токеном доступа или централизованный хостинг для нескольких пользователей

• Поддержка Docker — развертывание в любом месте с HTTPS

Быстрый старт

Локальный режим (stdio)

npm install && npm run build

Добавьте в настройки MCP для Claude Desktop или Claude Code:

{
  "mcpServers": {
    "bouncie": {
      "command": "node",
      "args": ["/path/to/bouncie-mcp/dist/index.js"],
      "env": {
        "BOUNCIE_ACCESS_TOKEN": "your-access-token"
      }
    }
  }
}

Режим Stdio использует предварительно полученный токен доступа Bouncie — без процесса OAuth. Используйте HTTP-режим для многопользовательских развертываний.

Удаленный режим (HTTP) с Docker

cp .env.example .env  # fill in your credentials
docker compose up -d

Сервер предоставляет следующие эндпоинты:

• /mcp — эндпоинт MCP (авторизация через Bearer token)

• /authorize — запуск процесса OAuth, перенаправление пользователя на Bouncie

• /callback — целевой адрес перенаправления OAuth от Bouncie

• /token — эндпоинт обмена токенами для MCP-клиентов

• /register — динамическая регистрация клиента по RFC 7591

• /.well-known/oauth-authorization-server — метаданные по RFC 8414

• /health — проверка работоспособности

Настройка приложения Bouncie

1. Зарегистрируйтесь на bouncie.dev и создайте приложение

2. Запишите свои Client ID и Client Secret

3. Установите Redirect URL на {PUBLIC_URL}/callback (например, https://bouncie.example.com/callback)

На этом работа с порталом завершена — пользователи авторизуются индивидуально через процесс OAuth при подключении через Claude.ai.

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

Режим Stdio (один пользователь)

Режим HTTP (несколько пользователей)

Инструменты

get_vehicles

Список всех транспортных средств в учетной записи с актуальной статистикой.

Возвращает: информацию об автомобиле (марка/модель/год, VIN, IMEI, псевдоним) и актуальную статистику (GPS-координаты, скорость, уровень топлива, одометр, статус работы двигателя, аккумулятор, индикатор Check Engine, DTC).

get_vehicle

Получение данных об одном автомобиле по VIN или IMEI. Требуется хотя бы один идентификатор.

get_trips

Получение истории поездок для автомобиля.

Максимальный диапазон дат — 1 неделя. По умолчанию — последние 7 дней.

Возвращает: расстояние, длительность, среднюю/максимальную скорость, расход топлива, количество случаев резкого торможения/ускорения, одометр, GPS-трек.

get_user

Получение профиля авторизованного пользователя.

Временные метки

Все временные метки API Bouncie указаны в формате UTC. Каждый автомобиль/поездка включает поле смещения часового пояса (localTimeZone или timeZone, например "-0500") для преобразования в местное время.

Разработка

npm run dev        # Run with tsx (hot reload)
npm run build      # Compile TypeScript
npm test           # Run tests (21 tests)
npm run lint       # Type check

Архитектура

• src/index.ts — точка входа для транспорта stdio

• src/http.ts — точка входа для HTTP/Express с OAuth

• src/server.ts — определения инструментов MCP

• src/api.ts — клиент REST API Bouncie

• src/oauth.ts — OAuth-провайдер, который проксирует OAuth от Claude.ai к Bouncie (поддерживается PKCE)

• src/types.ts — типы TypeScript для транспортных средств, поездок и событий вебхуков

События вебхуков Bouncie

API Bouncie также поддерживает вебхуки (документированы здесь для справки):

Лицензия

MIT