Witzense MCP

API DOCUMENT.pdf에 설명된 Witzense/JIMI 장치 추적 Open API를 위한 MCP 서버입니다.

추출된 Markdown 참조는 API DOCUMENT.md입니다. 126개 PDF 페이지를 모두 페이지 섹션으로 보존하며, 프로그래밍 방식으로 검색하고 처리하기 더 쉽습니다. PDF는 원본 소스로 유지되며, 이미지 전용 콘텐츠는 Markdown 추출에 포함되지 않습니다.

구성

.env.example을 로컬 환경 구성으로 복사하고 다음을 설정하세요:

• WITZENSE_BASE_URL: 기본값은 http://open.10000track.com/route/rest입니다.

• WITZENSE_APP_KEY 및 WITZENSE_APP_SECRET.

• WITZENSE_ACCOUNT 및 WITZENSE_PASSWORD_MD5 — 계정 비밀번호의 기존 32자 소문자 MD5입니다. 평문을 제공하지 말고 이 값을 다시 해시하지 마세요.

• WITZENSE_EXPIRES_IN: 토큰 수명 요청, 60초에서 7200초 사이.

• WITZENSE_REQUEST_ENCODING: 기본값은 form이며, 할당된 노드가 요구하는 경우 json입니다.

실제 자격 증명을 커밋하거나 소스 파일에 넣지 마세요.

Related MCP server: SORACOM Data Reader MCP

실행

npm install
npm run build
npm start

서버는 MCP stdio를 통해 통신합니다. 사용 가능한 도구는 다음과 같습니다:

• call_witzense_method

• list_witzense_child_accounts

• list_witzense_devices

• get_witzense_device

• get_witzense_device_locations

• list_witzense_account_locations

• get_witzense_track

• get_witzense_mileage

• get_witzense_shared_location_url

• list_witzense_alarms

• get_witzense_parking_report

• get_witzense_trips_report

• get_witzense_fence_duration_report

• get_witzense_obd_data

• get_witzense_obd_faults

• get_witzense_rfid_reports

• get_witzense_tag_location

• list_witzense_geofences

• get_witzense_geofence

• list_witzense_device_groups

• get_witzense_media_urls

• get_witzense_live_url

• get_witzense_rtmp_url

전용 도구는 읽기 지향적이며 공유 서명 클라이언트를 사용합니다.

Command Cloud 통합의 경우 각 Witzense 장치/IMEI는 해당 Command Cloud 자산/차량으로 처리됩니다. specs/commandcloud-mapping.md를 참조하세요.

API 동작

요청은 공통 매개변수, 액세스 토큰 및 대문자 UTF-8 MD5 서명과 함께 POST /route/rest를 사용합니다. 토큰은 jimi.oauth.token.get을 통해 획득하고, jimi.oauth.token.refresh를 통해 갱신되며, 메모리에 캐시됩니다.

PDF에는 TS, TSP HK, TSP EU 및 TSP US 노드가 나열됩니다. WITZENSE_BASE_URL을 통해 할당된 노드를 구성하세요. 노드 간 이동 시 도구 코드를 변경하지 마세요.

테스트

npm test

서버 배포

저장소 워크플로는 풀 리퀘스트를 빌드하고 테스트한 후 main에 푸시한 다음 /root/WITZENSE-MCP를 배포합니다. root@2.25.109.42가 수락하는 배포 키로 GitHub Actions 시크릿 DEPLOY_SSH_KEY를 구성하세요.

Witzense API 변수는 서버의 런타임 환경 또는 MCP 호스트 구성에 유지하세요. 이 변수는 의도적으로 배포 워크플로나 저장소에 포함되지 않습니다.

첫 서버 부트스트랩 및 스모크 테스트 명령은 DEPLOYMENT.md를 참조하세요.