BatterySnap MCP サーバー
AI アシスタントに Android バッテリー分析を尋ねる
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?)端末モデルの一覧を、デバイス数、平均温度、Android API の範囲、代表的な生の Build.MODEL 識別子(raw_model_code)、および BatterySnap のモデルページへの url(生のモデルコードがない場合は null)とともに返します。ブランドを 1 つ以上指定すると絞り込め、省略すると全ブランドが対象になります。並び順は名前順またはデバイス数順です。
devices(pairs)1 つ以上の {brand, model} の組み合わせについて個々の端末を列挙し、端末ごとの集計値(稼働期間、バッテリー残量、温度範囲、充電/放電速度、起動中の割合、Android API レベル、タイムゾーン)と BatterySnap の端末履歴ページへの url を返します。
集計
device_summary(device_uid)単一デバイスのバッテリー集計指標:平均/最低/最高温度、平均バッテリーレベル、電源別(AC・USB・ワイヤレス)の平均充電時間、直近(約 2 週間)と長期(約 2 か月)の平均放電時間、さらにアクティブ率、Android 情報、BatterySnap のデバイス履歴ページへの url。
MCP Apps に対応したクライアントでは、このツールはインタラクティブなバッテリー履歴グラフもその場に表示します。
model_summary(brand, model)特定のブランド+モデルに属する全デバイスのバッテリー指標分布:温度、バッテリーレベル、放電速度、AC/USB/ワイヤレス充電速度、アクティブ率の平均・中央値・p25・p75・最小・最大。さらに代表的な raw_model_code と BatterySnap のモデルページへの url も返します(生のモデルコードが無い場合は 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 回の呼び出しで、指定した指標について 1 台の端末を同一モデルの他端末および全体と比較します。その値、順位(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 によるページングと、デバイス数・モデル数の最小/最大フィルターにも対応しています。