tesla-fleet-mcp

Tesla Fleet API용 초경량 stdio MCP입니다. TypeScript. 단일 프로세스, 환경 변수 기반 시크릿, 읽기/깨우기용 추가 데몬이 필요 없습니다.

명령어(기후, 충전, 잠금)는 Tesla 공식 tesla-http-proxy와 차량 내 가상 키가 필요합니다. 해당 프록시는 포함되어 있지 않습니다.

Hermes 서버 이름: tesla-fleet. 도구는 mcp__tesla_fleet__*로 표시됩니다.

도구

vehicle_data를 폴링하지 마십시오. Tesla는 호출당 과금합니다. 먼저 vehicle_get을 확인하세요.

쉼표로 구분된 endpoints 쿼리는 메타데이터만 반환합니다(charge_state 없음). 이 서버는 쉼표를 ;로 다시 작성합니다.

요구 사항

• Node 20 이상

• Tesla 개발자 애플리케이션 (대시보드)

• 소유한 HTTPS 도메인 (tesla라는 단어가 포함되면 안 됨)

• https://<your-domain>/.well-known/appspecific/com.tesla.3p.public-key.pem에 공개 키

• 사용하는 각 리전의 파트너 POST /api/1/partner_accounts

• 결제 수단 + 청구 한도 (Fleet API는 사용량 기반 과금, 월 약 $10 크레딧)

환경 변수

env.example을 복사하고 TESLA_CACHE_PATH를 git 외부의 0600 파일로 지정하세요.

시크릿을 커밋하지 마십시오. 새로고침 토큰이나 클라이언트 시크릿을 채팅에 붙여넣지 마십시오.

설정 (1회)

1. Tesla 개발자 앱을 만듭니다. 권한 유형: 인증 코드 및 machine-to-machine.

2. 허용된 출처: https://your.domain. 허용된 리다이렉트: https://your.domain/callback.

3. 필요한 범위(일반적): openid, offline_access, vehicle_device_data, 그리고 해당 도구를 사용하는 경우 vehicle_cmds / vehicle_charging_cmds / vehicle_location.

4. P-256 키 쌍을 생성합니다:

openssl ecparam -name prime256v1 -genkey -noout -out private-key.pem
openssl ec -in private-key.pem -pubout -out public-key.pem

공개 키만 다음 위치에 호스팅하세요:

https://your.domain/.well-known/appspecific/com.tesla.3p.public-key.pem

5. 파트너 계정을 등록합니다 (EU 예시):

# partner token
curl -s --data-urlencode grant_type=client_credentials \
  --data-urlencode client_id="$TESLA_CLIENT_ID" \
  --data-urlencode client_secret="$TESLA_CLIENT_SECRET" \
  --data-urlencode audience="$TESLA_AUDIENCE" \
  --data-urlencode scope='openid vehicle_device_data vehicle_cmds' \
  https://fleet-auth.prd.vn.cloud.tesla.com/oauth2/v3/token

# then POST {"domain":"your.domain"} to $TESLA_AUDIENCE/api/1/partner_accounts
# with Authorization: Bearer <partner access_token>

6. 사용자 로그인 (차량 소유자):

set -a && source .env && set +a
npm install
npm run login
# open the printed URL, approve, paste the full https://your.domain/callback?code=... URL:
npm run login -- "https://your.domain/callback?code=...."

콜백 호스트는 브라우저 접속을 수신하기만 하면 됩니다. 이 CLI는 붙여넣은 URL을 읽습니다. 빈 페이지여도 괜찮습니다.

Hermes

# example wrapper: source your env file, then tsx
hermes mcp add tesla-fleet --command /path/to/tesla-fleet-mcp/run.sh

run.sh는 저장소 디렉터리 또는 $TESLA_ENV에 설정된 경우 해당 파일의 .env를 소싱합니다. 추가 후 Hermes 프로세스/게이트웨이를 다시 시작하세요. 추가 서버 플래그 대신 클라이언트(tools.include / exclude)에서 도구를 활성화/비활성화하세요.

명령어 (선택 사항)

Model 3 / Y 및 최신 S/X는 Vehicle Command Protocol이 필요합니다. 서명되지 않은 Fleet 명령 호출은 거부됩니다.

1. 개인 키와 TLS로 tesla-http-proxy를 실행하세요. 로컬 호스트 전용.

2. 가상 키를 페어링하세요 (Tesla 앱, 차량 온라인 상태): https://tesla.com/_ak/your.domain

3. TESLA_COMMAND_BASE=https://127.0.0.1:4443을 설정하세요 (NODE_EXTRA_CA_CERTS는 프록시 인증서가 자체 서명된 경우).

프록시를 인터넷에 공개하지 마십시오.

개발

npm test
npx tsc --noEmit

라이선스

MIT