analyze_activity
Analyzes Strava activity data to extract performance metrics and insights. Provide an activity ID to receive detailed analysis results.
Instructions
Анализ активности из Strava
Args:
activity_id: ID активности (строка или число)
Returns:
dict: Результаты анализа активностиInput Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| activity_id | Yes |
Implementation Reference
- src/server.py:336-374 (handler)Main MCP tool handler: analyzes Strava activity by ID, computes pace and effort using helpers, returns structured dict with stats and analysis.
@mcp.tool() def analyze_activity(activity_id: Union[str, int]) -> dict: """Анализ активности из Strava Args: activity_id: ID активности (строка или число) Returns: dict: Результаты анализа активности """ activity_id = str(activity_id) try: activity = get_activity(activity_id) # Calculate pace and zones pace = _calculate_pace(activity) effort = _calculate_effort(activity) return { "type": activity.get("type"), "distance": activity.get("distance"), "moving_time": activity.get("moving_time"), "average_heartrate": activity.get("average_heartrate"), "analysis": { "pace": pace, "effort": effort, "stats": { "elapsed_time": activity.get("elapsed_time"), "elevation_gain": activity.get("total_elevation_gain"), "calories": activity.get("calories"), } }, } except Exception as e: logger.error(f"Ошибка анализа активности {activity_id}: {e}") return { "error": f"Не удалось проанализировать активность: {str(e)}", "activity_id": activity_id } - src/server.py:376-387 (helper)Calculates activity pace: minutes per km for running, km/h for cycling.
def _calculate_pace(activity: dict) -> float: """Расчет темпа активности""" try: if activity.get("type") == "Run": # Для бега: мин/км return (activity.get("moving_time", 0) / 60) / (activity.get("distance", 0) / 1000) elif activity.get("type") == "Ride": # Для велосипеда: км/ч return (activity.get("distance", 0) / 1000) / (activity.get("moving_time", 0) / 3600) return 0 except (TypeError, ZeroDivisionError): return 0 - src/server.py:389-399 (helper)Estimates training effort level ('Легкая', 'Средняя', 'Высокая') based on average heart rate zones.
def _calculate_effort(activity: dict) -> str: """Оценка нагрузки""" if "average_heartrate" not in activity: return "Неизвестно" hr = activity["average_heartrate"] if hr < 120: return "Легкая" if hr < 150: return "Средняя" return "Высокая" - src/server.py:336-336 (registration)MCP tool decorator that registers the analyze_activity function as a tool.
@mcp.tool() - src/server.py:338-344 (schema)Docstring providing tool description, input parameter (activity_id: str|int), and output (dict with analysis). Serves as schema for MCP.
"""Анализ активности из Strava Args: activity_id: ID активности (строка или число) Returns: dict: Результаты анализа активности """