circle-mcp

MCP-сервер (stdio), предоставляющий доступ только для чтения к данным родительского контроля Circle (Meetcircle/Aura): семейные профили и использование интернета по каждому профилю.

Извлечено из провайдера Circle в airstream-dashboard, откуда взяты API-клиент и его поток аутентификации. Клиент только на стандартной библиотеке; единственная зависимость — SDK mcp.

Инструменты

Related MCP server: openbanking-mcp

Настройка

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

Конфигурация

Переменные окружения имеют приоритет; файл секретов заполняет остальное:

CIRCLE_SECRETS_FILE указывает на файл конфигурации со строками circle.<ключ> = <значение>, что позволяет не хранить учётные данные в конфигурации вашего MCP-клиента.

Регистрация в Claude Code: скопируйте .mcp.json.example в .mcp.json и заполните свои учётные данные (или укажите CIRCLE_SECRETS_FILE на файл конфигурации, содержащий их). .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>} → admin 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"} — ключ принят, имя пользователя/пароль отклонены