Smartcar MCP 서버

AI 에이전트를 위한 Smartcar 차량 API를 도구로 노출하는 MCP (Model Context Protocol) 서버입니다. Claude, ChatGPT 및 기타 MCP 호환 클라이언트가 자연어를 사용하여 차량 원격 측정 데이터를 조회하고 명령을 보낼 수 있도록 합니다.

개요

이 서버는 OAuth2 클라이언트 자격 증명을 사용하여 Smartcar의 M2M(기기 간) API를 래핑합니다. 토큰 획득 및 캐싱을 자동으로 처리하므로 AI 에이전트는 인증을 관리할 필요 없이 차량과 상호 작용할 수 있습니다.

4개 카테고리에 걸친 16개의 도구:

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 (내연기관): 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초 전에 자동으로 갱신됩니다. 수동 토큰 관리는 필요하지 않습니다.