circle-mcp

MCPサーバー（stdio）は、読み取り専用のCircle（Meetcircle/Aura）ペアレンタルコントロールデータ（家族プロフィールとプロフィールごとのインターネット使用状況）を公開します。

airstream-dashboard Circleプロバイダーから抽出されたもので、APIクライアントとその認証フローはそこに由来します。標準ライブラリのみのクライアントで、唯一の依存関係はmcp SDKです。

ツール

Related MCP server: openbanking-mcp

セットアップ

python3 -m venv .venv
.venv/bin/pip install -e .

設定

環境変数が優先されます。シークレットファイルが残りを補完します：

CIRCLE_SECRETS_FILEはcircle.<key> = <value>行を含むconfファイルを指し、MCPクライアント設定から資格情報を除外します。

Claude Code登録：.mcp.json.exampleを.mcp.jsonにコピーし、資格情報を入力します（またはCIRCLE_SECRETS_FILEをそれらを保持するconfファイルに指定します）。.mcp.jsonは通常、資格情報やマシン固有のパスを埋め込むため、gitignoreされています。

APIメモ（2026-08）

認証フロー：

1. POST https://api.aurasvc.io/auth/session/signin、ヘッダーAuthorization: Public <aura_public_key>、ボディ{"alias": <email>, "password": ...} → access_token + refresh_token（/auth/session/refresh_token経由で更新）

2. POST https://auth.meetcircle-blue.co/api/v2/grant/admin、{"deviceid": <device_id>, "jwt": <access_token>} → 管理者トークン

3. https://vc.meetcircle-blue.co上のデータエンドポイント、Authorization: Bearer <admin_token>：

   • /api/LOGS/usage/categories?user=<pid>&day=<d>&ndays=<n>（ライブで検証済み）

   • /api/LOGS/usage?user=<pid>&day=<d>&ndays=<n>

   • /api/QUERY/users、/api/QUERY/circleinfo（未検証）

サインイン時のエラーセマンティクス：

• 401 {"message": "NoCredential"} — Authorization: Public <key>ヘッダーが欠落/無効

• 401 {"message": "InvalidCredentials"} — キーは受け入れられたが、ユーザー名/パスワードが拒否された