cygnusb/coros-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

123 stars 33 forks 품질 81 트렌드 36MIT

Repository Install

cygnusb/coros-mcp는 [[T0]에서 가져온 MCP 서버 후보입니다.

개요

cygnusb/coros-mcp는 [[T0]에서 가져온 MCP 서버 후보입니다.

개요(AI 번역)

[! 중요] 이 프로젝트는 비공식적이고 지역사회가 만든 프로젝트이며 COROS와 제휴하거나 승인하지 않습니다.

COROS는 이후 공식 MCP 서버인 coroslab/COROS-MCP를 출시했습니다. 공식 지원되는 통합을 원하신다면 그걸 사용하시길 바랍니다.

이 프로젝트는 커뮤니티 대안으로 계속 존재하며, 다르거나 상호 보완적인 기능을 제공할 수 있습니다.

비공식 Coros API에서 수면, HRV, 학습 데이터를 가져오고 Claude 같은 AI 어시스턴트에 노출시키는 모델 컨텍스트 프로토콜(MCP) 서버입니다.

API 키는 필요 없습니다. 이 서버는 Coros Training Hub 자격 증명으로 직접 인증합니다. 토큰은 시스템 키링(또는 백업으로 암호화된 로컬 파일)에 안전하게 저장되며, Coros로만 전송됩니다.

당신이 할 수 있는 것

AI 비서에게 다음과 같은 질문을 해보세요:

“지난주에 깊은 수면과 REM 수면을 얼마나 했나요?”
“지난 4주간 내 HRV 추세는 어땠나요?”
“지난주 내 안정 심박수와 훈련량을 보여줘”
“이번 달에 하루 평균 몇 걸음이나 걸었나요?”
“지난달 내 라이딩 목록”
“내 마지막 긴 여정의 세부 사항을 보여줘”

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

coros-mcp

[!IMPORTANT] This is an unofficial, community-built project and is not affiliated with or endorsed by COROS.

COROS has since launched their official MCP server: coroslab/COROS-MCP. If you are looking for an officially supported integration, please use that instead.

This project continues to exist as a community alternative and may offer different or complementary features.

A Model Context Protocol (MCP) server that fetches sleep, HRV, and training data from the unofficial Coros API and exposes them to AI assistants like Claude.

No API key required. This server authenticates directly with your Coros Training Hub credentials. Your token is stored securely in your system keyring (or an encrypted local file as fallback), never transmitted anywhere except to Coros.

What You Can Do

Ask your AI assistant questions like:

“How much deep sleep and REM did I get last week?”
“What was my HRV trend over the last 4 weeks?”
“Show me my resting heart rate and training load for last week”
“How many steps did I average per day this month?”
“List my rides from last month”
“Show me the details of my last long ride”
“Create a 90-minute sweet spot workout for me”
“What’s on my training calendar next week?”
“Schedule my VO2 workout for Thursday”
“Create a 20-minute strength circuit with squats, lunges, and planks”

Features

Tool	Description
`authenticate_coros`	Log in with email and password — token stored securely in keyring
`authenticate_coros_mobile`	Log in to the mobile API only (useful for sleep data troubleshooting)
`check_coros_auth`	Check whether a valid auth token is present
`get_daily_metrics`	Fetch daily metrics (HRV, resting HR, training load, VO2max, stamina, and more) for n weeks (default: 4)
`get_sleep_data`	Fetch nightly sleep stages (deep, light, REM, awake) and sleep HR for n weeks (default: 4)
`list_activities`	List activities for a date range with summary metrics
`get_activity_detail`	Fetch full detail for a single activity (laps, HR zones, power zones)
`list_workout_templates`	List reusable workout templates saved in the library
`save_workout_template`	Save a reusable cycling/intervals workout template (named steps, power targets)
`save_strength_workout_template`	Save a reusable strength workout template (sets, reps, or timed exercises)

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "coros": {
      "command": "/path/to/coros-mcp/.venv/bin/coros-mcp",
      "args": ["serve"]
    }
  }
}