coros-mcp (сообщество)
coros-mcp
Неофициальный MCP-сервер Coros: сон, HRV, нагрузка и тренировки из Training Hub и планирование занятий в календаре.
- 125 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Хранит учетные данные Coros и читает данные о здоровье: сон, пульс, нагрузку.
- Инструменты записи меняют шаблоны тренировок и календарь в аккаунте.
Установка
- Работает в
Ручная установка
git clone https://github.com/cygnusb/coros-mcp.git
cd coros-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -e .Ручная установка из README, шаг 1.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Хранит учетные данные Coros и читает данные о здоровье: сон, пульс, нагрузку.
- Инструменты записи меняют шаблоны тренировок и календарь в аккаунте.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер входит в Coros Training Hub под вашими учетными данными и отдает агенту сон по фазам, HRV, пульс покоя, тренировочную нагрузку, VO2max и подробности тренировок: круги, зоны пульса и ватт. Он же ведет библиотеку шаблонов и календарь: агент создает интервальную или силовую тренировку, ставит ее на день и удаляет из плана. Всего 26 инструментов; режим `COROS_MCP_TOOLSET=readonly` оставляет 12 инструментов чтения. История синхронизируется в локальную базу SQLite, поэтому старые данные отдаются из кеша, а у API запрашивается только свежий хвост. Токены хранятся в системной связке ключей или в зашифрованном файле.
Для кого. Спортсмены и тренеры на часах Coros, которые разбирают сон, восстановление и нагрузку с помощью агента.
Подходит, если
- Нужно сравнить глубокий сон и REM за прошлую неделю.
- Тренд HRV за четыре недели надо посмотреть рядом с тренировочной нагрузкой.
- Агент создает девяностоминутную тренировку и ставит ее на четверг.
- Историю за годы выгружают в локальный кеш для быстрых запросов.
Не подходит, если
- Нужна официально поддерживаемая интеграция: у Coros есть собственный MCP-сервер.
- Постоянно пользуетесь мобильным приложением Coros: вход мобильного API разлогинивает телефон.
- Пароль нельзя хранить в `.env` или связке ключей машины.
Пример запроса к агенту
Сколько глубокого сна и REM было на прошлой неделе и как изменился HRV за четыре недели?MCP
- Транспорт
- stdio
- Авторизация
- ключ необязателен
Переменные окружения
COROS_EMAIL- Почта аккаунта Coros для автоматического входа.
COROS_PASSWORDсекрет- Пароль аккаунта Coros для автоматического входа.
COROS_REGION- Регион аккаунта: eu, us или asia.
COROS_MCP_TOOLSET- Значение readonly оставляет только инструменты чтения.
COROS_MCP_HIDE_AUTH_TOOLS- Значение 1 скрывает инструменты authenticate_*.
Ограничения
Проект неофициальный и не связан с Coros: он использует недокументированный API Training Hub, который может измениться без предупреждения. Сама Coros выпустила официальный MCP-сервер `coroslab/COROS-MCP`, и README советует выбирать его, если нужна поддерживаемая интеграция. Мобильный вход (`apieu.coros.com`) разлогинивает приложение на телефоне, чтобы этого избежать, используйте `coros-mcp auth-web`. Установка идет из клонированного репозитория через `pip install -e .`, нужен Python 3.11 или новее. Инструменты записи меняют библиотеку шаблонов и календарь, поэтому для автономных агентов есть режим `readonly`.
Как отключить. Выполните `claude mcp remove coros` или уберите запись `coros` из конфигурации клиента, затем `coros-mcp auth-clear`, чтобы стереть токены. Локальную базу SQLite удалите вручную.
Частые вопросы
Чем неофициальный coros-mcp отличается от официального?
Это проект сообщества на недокументированном API Training Hub, а Coros выпустила собственный `coroslab/COROS-MCP`. Версия сообщества может дать другие функции, но поддержки вендора у нее нет.
Как скрыть пароль от модели?
Задайте `COROS_MCP_HIDE_AUTH_TOOLS=1`: инструменты `authenticate_*` пропадут, а вход пойдет через `COROS_EMAIL` и `COROS_PASSWORD` или заранее сохраненные токены.
Как оставить только чтение?
Задайте `COROS_MCP_TOOLSET=readonly`. Останутся 12 инструментов чтения, а запись в аккаунт Coros будет скрыта.
Как пройти авторизацию?
Выполните `coros-mcp auth` в терминале вне сессии агента и укажите почту, пароль и регион (eu, us или asia). Токены сохранятся в системной связке ключей.
Нужен ли API-ключ для coros-mcp?
Нет. Сервер входит с учетными данными Coros Training Hub, а токен хранится в системной связке ключей или в зашифрованном файле.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыОфициальный MCP COROS: агент читает тренировки, сон и пульс и составляет планы тренировок, сохраняя их в аккаунт.
MCP-сервер только для чтения: восстановление, сон, HRV, нагрузка и тренировки из WHOOP в Claude, Codex и Cursor.
MCP-сервер для учета тренировок: Claude Desktop, Cursor и Cline читают программы, подходы, вес тела и 1ПМ из вашего самостоятельно развернутого openGym
Garmin Personal MCP отвечает на вопросы о сне, HRV и тренировках по данным аккаунта Garmin Connect, только чтение
MCP-сервер для локальной базы Zepp и Amazfit: агент читает сон, пульс, тренировки и готовит план, данные остаются у вас
intervals-icu-mcp — тренировки из Intervals.icu в агенте
intervals-icu-mcp
MCP-сервер дает Claude и ChatGPT читать и менять данные Intervals.icu: тренировки, самочувствие, календарь, планы
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| coros-mcp (сообщество) (эта карточка) | нет | ключ необязателен | 125 | |
| COROS MCP | да | OAuth | 82 | официальный сервер вендора Coros; эта карточка описывает неофициальный проект сообщества на недокументированном API |
| Garmin MCP | нет | API-ключ | 1 498 | читает данные часов Garmin; coros-mcp работает с аккаунтом Coros Training Hub |
Коротко о README
Описаны примеры запросов, установка и подключение к Claude Code и Claude Desktop, три способа входа, режим только чтения и справочник по инструментам.