{"id":31703601,"url":"https://github.com/colinfrisch/chathletique-mcp","last_synced_at":"2026-03-17T02:38:21.626Z","repository":{"id":314638555,"uuid":"1056104173","full_name":"colinfrisch/chathletique-mcp","owner":"colinfrisch","description":"Strava Coach MCP Server 🏆 MISTRAL MCP HACKATHON WINNER 🏆","archived":false,"fork":false,"pushed_at":"2025-09-23T17:09:42.000Z","size":330,"stargazers_count":5,"open_issues_count":1,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-23T19:11:30.970Z","etag":null,"topics":["agentic-ai","hackathon","mcp","mistral","mistral-ai","winner"],"latest_commit_sha":null,"homepage":"https://chat.mistral.ai/chat","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/colinfrisch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-13T11:53:16.000Z","updated_at":"2025-09-22T16:08:52.000Z","dependencies_parsed_at":"2025-09-14T22:21:26.259Z","dependency_job_id":null,"html_url":"https://github.com/colinfrisch/chathletique-mcp","commit_stats":null,"previous_names":["colinfrisch/hack","colinfrisch/chathletique-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/colinfrisch/chathletique-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colinfrisch%2Fchathletique-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colinfrisch%2Fchathletique-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colinfrisch%2Fchathletique-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colinfrisch%2Fchathletique-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/colinfrisch","download_url":"https://codeload.github.com/colinfrisch/chathletique-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colinfrisch%2Fchathletique-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279000733,"owners_count":26082851,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-08T02:00:06.501Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-ai","hackathon","mcp","mistral","mistral-ai","winner"],"created_at":"2025-10-08T22:06:12.524Z","updated_at":"2025-10-08T22:06:13.501Z","avatar_url":"https://github.com/colinfrisch.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"#  Strava Coach MCP Server\n\n### 🏆 MISTRAL MCP HACKATHON WINNER 🏆\n\n**@Loucienne** \u003c/n\u003e\n**@leotrois** \u003c/n\u003e\n**@gregoire-rouviere** \u003c/n\u003e\n**@Ulysse6307** \u003c/n\u003e\n**@colinfrisch** \u003c/n\u003e\n\nA Model Context Protocol (MCP) server that provides AI assistants with access to Strava running data, route planning, and weather information. This server enables intelligent running coaching by combining Strava activity analysis with real-time weather data and route generation capabilities.\n\n\n## Setup\n\n### Prerequisites\n- Python 3.13+\n- Active Strava account with API access\n- OpenWeatherMap API key\n- OpenRouteService API key\n\n### Environment Variables\nCreate a `.env` file in the project root with the following variables:\n\n```env\nSTRAVA_ACCESS_TOKEN=your_strava_access_token\nWEATHER_API_KEY=your_openweathermap_api_key\nORS_KEY=your_openrouteservice_api_key\n```\n\n#### Getting API Keys (all for free)\n\n**Strava API Token:**\n1. Go to [Strava API Settings](https://www.strava.com/settings/api)\n2. Create an application if you haven't already\n3. Use the \"Create \u0026 View a Refresh Token\" tool or follow Strava's OAuth flow\n4. Copy the access token\n\n**OpenWeatherMap API Key:**\n1. Sign up at [OpenWeatherMap](https://openweathermap.org/api)\n2. Subscribe to the 5 Day / 3 Hour Forecast API (free tier available)\n3. Copy your API key\n\n**OpenRouteService API Key:**\n1. Register at [OpenRouteService](https://openrouteservice.org/)\n2. Get your free API key from the dashboard\n\n### Installation\n\n1. **Clone and setup:**\n```bash\ngit clone \u003cyour-repo-url\u003e\ncd chathletique-mcp\n```\n\n2. **Install Python dependencies:**\n```bash\n# Install project dependencies\npip install -e .\n\n# Install development dependencies (for contributing)\npip install -e \".[dev]\"\n```\n\n3. **Configure environment:**\n```bash\n# Create .env file with your API keys\ncp .env.example .env\n# Edit .env with your actual API keys\n```\n\n4. **Set up code quality tools (for contributors):**\n```bash\n# Install pre-commit hooks for automatic code quality checks\npre-commit install\n\n# Optional: Run pre-commit on all files to check everything\npre-commit run --all-files\n```\n\n\n## Architecture\n\nThe server is built using:\n- **FastMCP**: For MCP protocol implementation\n- **Stravalib**: For Strava API integration\n- **OpenRouteService**: For route generation\n- **OpenWeatherMap API**: For weather data\n- **Matplotlib**: For data visualization\n\n### Project Structure\n```\nchathletique-mcp/\n├── src/strava_mcp/\n│   ├── __init__.py      # Package initialization\n│   ├── main.py          # MCP server entry point\n│   ├── strava_tools.py  # Strava API integration tools\n│   ├── weather_tools.py # Weather prediction tools\n│   └── mcp_utils.py     # MCP server configuration\n├── tests/               # Test suite\n├── .pre-commit-config.yaml  # Code quality configuration\n├── pyproject.toml       # Project configuration and dependencies\n├── uv.lock             # Lock file for reproducible installs\n└── README.md           # This file\n```\n\n## 🛠️ Development \u0026 Code Quality\n\nThis project uses modern Python development tools for maintaining high code quality:\n\n### Code Quality Tools\n\n- **Ruff**: Ultra-fast Python linter and formatter with comprehensive rules\n- **MyPy**: Static type checking for better code reliability\n- **Pre-commit**: Automatic code quality checks before each commit\n- **Pytest**: Testing framework with coverage reporting\n- **Black**: Code formatting (integrated with Ruff)\n\n### Pre-commit Hooks\n\nThe project includes automatic quality checks that run before each commit:\n\n1. **Code formatting**: Automatic code formatting with Ruff\n2. **Import sorting**: Organize imports consistently\n3. **Linting**: Check for bugs, security issues, and style problems\n4. **Type checking**: Verify type annotations with MyPy\n5. **Docstring validation**: Enforce Google-style docstrings\n6. **Security scanning**: Detect potential security vulnerabilities\n7. **Spell checking**: Catch typos in code and documentation\n\n\n## Use Cases\n\n- **AI Running Coach**: Integrate with Le Chat or other AI assistants for personalized running advice\n- **Training Analysis**: Analyze performance trends and provide insights\n- **Route Discovery**: Generate new running routes based on preferences and weather\n- **Weather-aware Planning**: Plan runs based on upcoming weather conditions\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcolinfrisch%2Fchathletique-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcolinfrisch%2Fchathletique-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcolinfrisch%2Fchathletique-mcp/lists"}