BatterySnap MCP 서버
AI 어시스턴트에 안드로이드 배터리 분석 묻기
BatterySnap은 Model Context Protocol 서버를 제공하므로, MCP 호환 AI 어시스턴트가 필요할 때 브랜드, 모델, 기기별 배터리 통계를 조회할 수 있습니다. 인증이 필요 없습니다.
https://mcp.battery-snap.com/mcp
전송 방식
streamable-http
클라이언트에 설치
claude_desktop_config.json을 편집(설정 → 개발자 → 구성 편집)하고 다음을 추가하세요:
{
"mcpServers": {
"batterysnap": {
"type": "http",
"url": "https://mcp.battery-snap.com/mcp"
}
}
}
네이티브 HTTP 전송을 지원하지 않는 이전 버전에서는 mcp-remote 브리지를 사용하세요:
{
"mcpServers": {
"batterysnap": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.battery-snap.com/mcp"]
}
}
}
터미널에서 한 번 실행:
claude mcp add --transport http batterysnap https://mcp.battery-snap.com/mcp
~/.cursor/mcp.json을 만들거나 편집하여 다음을 입력하세요:
{
"mcpServers": {
"batterysnap": {
"url": "https://mcp.battery-snap.com/mcp"
}
}
}
librechat.yaml의 mcpServers 아래에 추가하세요:
mcpServers:
batterysnap:
type: streamable-http
url: https://mcp.battery-snap.com/mcp
작업 영역의 .vscode/mcp.json이나 사용자 설정에 추가하세요:
{
"servers": {
"batterysnap": {
"type": "http",
"url": "https://mcp.battery-snap.com/mcp"
}
}
}
streamable-http 전송을 지원하는 모든 MCP 호스트는 https://mcp.battery-snap.com/mcp을 가리켜 연결할 수 있습니다. 디스커버리 메타데이터는 /.well-known/mcp.json에서 제공됩니다.
사용 가능한 도구
여기서 시작
search(query, limit?)자유 형식 텍스트(브랜드, 모델명, 원시 Build.MODEL 코드 또는 이들의 조합)를 다른 도구가 요구하는 표준 브랜드·모델 식별자로 변환합니다. 다른 도구는 정확히 일치하는 값만 찾으므로, 일상적인 표현으로 기기를 언급할 때는 여기서 시작하세요.
카탈로그
brands(limit?, offset?, count filters?)배터리 통계 기록이 있는 모든 기기 브랜드를 모델 및 기기 수와 BatterySnap의 브랜드 페이지 url과 함께 나열합니다.
models(brands?, sort?, limit?, offset?)기기 모델 목록을 기기 수, 평균 온도, 안드로이드 API 범위, 대표 원시 Build.MODEL 식별자(raw_model_code), BatterySnap 모델 페이지 url(원시 모델 코드가 없으면 null)과 함께 반환합니다. 브랜드를 하나 이상 지정해 범위를 좁히거나, 생략해 모든 브랜드를 포함할 수 있으며, 이름순 또는 기기 수순으로 정렬합니다.
devices(pairs)하나 이상의 {brand, model} 쌍에 대해 개별 기기를 나열하고 기기별 집계를 제공합니다: 활동 기간, 배터리 잔량, 온도 범위, 충전·방전 속도, 깨어 있는 비율, 안드로이드 API 레벨, 시간대, 그리고 BatterySnap 기기 기록 페이지 url.
집계
device_summary(device_uid)특정 기기 한 대의 집계 배터리 지표: 평균/최저/최고 온도, 평균 배터리 레벨, 전원별(AC, USB, 무선) 평균 충전 시간, 최근(~2주) 및 장기(~2개월) 창의 평균 방전 시간, 활성 시간 비율, 안드로이드 정보와 BatterySnap의 기기 이력 페이지 url까지.
MCP Apps를 지원하는 클라이언트에서는 이 도구가 대화형 배터리 기록 그래프도 함께 표시합니다.
model_summary(brand, model)지정된 브랜드 + 모델의 모든 기기에 대한 배터리 지표 분포: 온도, 배터리 레벨, 방전 속도, AC/USB/무선 충전 속도, 활성 시간 비율의 평균, 중앙값, p25, p75, 최소, 최대. 또한 대표 raw_model_code와 BatterySnap의 모델 페이지 url도 반환합니다(raw 모델 코드가 없으면 null).
fleet_summary(brand?)model_summary와 동일한 분포 통계를 전체 플릿 또는 brand가 주어졌을 때 단일 브랜드에 대해 제공합니다. 기기나 모델을 비교할 때 기준선으로 유용합니다.
fleet_totals()플릿 전체의 라이브 카운터: 전체 기기, 모델, 스냅샷, 세션 수와 스냅샷 수집 속도(초당 건수), 최신 삽입 배치 시각. 데이터셋 규모와 증가 속도를 답하는 데 유용합니다.
순위
top_devices(metric, order?, brand?, model?, limit?, min_snapshots?)임의의 배터리 지표로 개별 기기 순위를 매깁니다 — 가장 뜨거운 기기, 가장 오래가는 기기, 가장 빨리 충전되는 기기 — 브랜드·모델 필터는 선택 사항입니다. 스냅샷 수가 min_snapshots(기본값 100)보다 적은 기기는 제외되므로 표본이 적은 기기가 순위를 차지할 수 없습니다.
top_models(metric, order?, brand?, limit?, min_devices?)같은 순위를 모델 단위로 산출합니다. 한 모델의 모든 기기를 집계한 뒤 이상치에 강한 중앙값으로 정렬하며, 평균값도 함께 반환합니다. min_devices(기본값 3)로 최소 표본 크기를 지정합니다.
device_ranking(device_uid, metric?)한 번의 호출로 특정 지표에서 한 기기를 같은 모델의 다른 기기 및 전체 기기군과 비교합니다: 해당 값, 순위(1부터), 백분위, 그리고 두 집단 각각의 중앙값 / 평균 / 최솟값 / 최댓값.
top_devices_by_uptime(brand?, model?, limit?)재부팅 사이에 기록된 가장 긴 단일 가동 시간 순으로 정렬된 기기. 브랜드 및 모델 필터는 선택 사항입니다. device_summary로 이어 호출할 수 있는 짧은 device_uid 목록(각 항목에 BatterySnap의 해당 기기 이력 페이지 url 포함)을 반환합니다.
top_devices_by_live_uptime(brand?, model?, limit?)top_devices_by_uptime과 동일한 순위지만, 가동 시간이 아직 재부팅으로 끊기지 않은 기기로 제한됩니다. 실시간으로 계속 증가하는 중입니다. 각 항목에는 해당 기기 이력 페이지로 가는 url도 포함됩니다.
top_devices, top_models, device_ranking이 허용하는 지표: temperature_c, max_temperature_c, min_temperature_c, battery_level_pct, discharge_hours, ac_charge_hours, usb_charge_hours, wireless_charge_hours, awake_ratio, snapshot_count, uptime_hours. 충전·방전 값은 100포인트를 전부 변화시키는 데 걸리는 시간(시간 단위)이므로, 값이 작을수록 충전이 빠르고 클수록 배터리가 오래갑니다.
brands, models, devices 도구는 선택적인 fields 인자도 받습니다. 응답을 컴팩트하게 유지하려면 속성 이름의 화이트리스트를 전달하세요.
brands와 models는 limit / offset 페이징과 기기 수·모델 수의 최소 / 최대 필터도 함께 지원합니다.