{"id":48637810,"url":"https://github.com/hifly81/bikescout","last_synced_at":"2026-05-14T13:02:01.241Z","repository":{"id":349204814,"uuid":"1200833004","full_name":"hifly81/bikescout","owner":"hifly81","description":"The MCP server for tactical cycling intelligence: Predictive mud logic, S-Scale terrain analysis, and AI-powered GPX routing,","archived":false,"fork":false,"pushed_at":"2026-05-05T14:29:07.000Z","size":1527,"stargazers_count":14,"open_issues_count":7,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-05T15:32:17.163Z","etag":null,"topics":["ai-agent","ai-tools","anthropic-claude","cycling","geojson","gps-navigation","gpx-generator","llm-agents","mcp-server","model-context-protocol","mountain-bike","openrouteservice","openstreetmap","outdoor-activities","overpass-api","python","strava-api","trails"],"latest_commit_sha":null,"homepage":"https://hifly81.github.io/bikescout/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hifly81.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","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":"2026-04-03T22:03:10.000Z","updated_at":"2026-05-05T14:31:26.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/hifly81/bikescout","commit_stats":null,"previous_names":["hifly81/bikescout"],"tags_count":35,"template":false,"template_full_name":null,"purl":"pkg:github/hifly81/bikescout","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hifly81%2Fbikescout","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hifly81%2Fbikescout/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hifly81%2Fbikescout/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hifly81%2Fbikescout/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hifly81","download_url":"https://codeload.github.com/hifly81/bikescout/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hifly81%2Fbikescout/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33026049,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-13T13:14:54.681Z","status":"online","status_checked_at":"2026-05-14T02:00:06.663Z","response_time":57,"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":["ai-agent","ai-tools","anthropic-claude","cycling","geojson","gps-navigation","gpx-generator","llm-agents","mcp-server","model-context-protocol","mountain-bike","openrouteservice","openstreetmap","outdoor-activities","overpass-api","python","strava-api","trails"],"created_at":"2026-04-09T13:09:37.391Z","updated_at":"2026-05-14T13:02:01.209Z","avatar_url":"https://github.com/hifly81.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BikeScout - AI for tactical cycling intelligence\n\n[![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-red.svg)](https://www.gnu.org/licenses/agpl-3.0)\n[![Version](https://img.shields.io/badge/Version-1.4.1-green.svg)](https://github.com/hifly81/bikescout/releases)\n![Python](https://img.shields.io/badge/python-3.10-blue.svg)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)\n\nBikeScout is a specialized AI engine for MTB, Road, E-Bike, and Gravel mission planning.\nIt transforms raw map data into Tactical Intelligence, predicting terrain conditions and trail hazards.\nThe system provides precise setup advice, tailoring your equipment to the demands of the specific route, identifying technical challenges and environmental risks before you even leave the garage.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg width=\"632\" height=\"345\" alt=\"logo-medium\" src=\"https://github.com/user-attachments/assets/f7e15304-0a91-465d-9c7f-ba35933609ed\" /\u003e\n\u003c/p\u003e\n\n---\n\n## Quickstart\n\n* **[How to use BikeScout](https://hifly81.github.io/bikescout/documentation/index.html#quickstart)** :\n*  - using the **[BikeScout GUI](https://hifly81.github.io/bikescout/documentation/index.html#gui)**\n*  - using your favourite MCP Agent client: [Claude Desktop, Cursor, Codex, Google Antigravity, Windsurf](https://hifly81.github.io/bikescout/documentation/index.html#mcp-gui)\n\n\u003cdetails\u003e\n  \u003csummary style=\"cursor: pointer;\"\u003e\n    \u003ch3 style=\"display: inline;\"\u003e📸 Click to watch BikeScout GUI.\u003c/h3\u003e\n  \u003c/summary\u003e\n  \u003cp align=\"center\"\u003e\n    \u003cimg src=\"docs/images/gui.png\" alt=\"BikeScout GUI\" width=\"100%\"\u003e\n  \u003c/p\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary style=\"cursor: pointer;\"\u003e\n    \u003ch3 style=\"display: inline;\"\u003e📸 Click to watch BikeScout with Cursor.\u003c/h3\u003e\n  \u003c/summary\u003e\n  \u003cp align=\"center\"\u003e\n    \u003cimg src=\"docs/images/collage.png\" alt=\"Cursor\" width=\"100%\"\u003e\n  \u003c/p\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary style=\"cursor: pointer;\"\u003e\n    \u003ch3 style=\"display: inline;\"\u003e📸 Click to watch BikeScout with Google Antigravity.\u003c/h3\u003e\n  \u003c/summary\u003e\n  \u003cp align=\"center\"\u003e\n    \u003cimg src=\"docs/images/collage-1.png\" alt=\"Google Antigravity\" width=\"100%\"\u003e\n  \u003c/p\u003e\n\u003c/details\u003e\n\n\n\u003cdetails\u003e\n  \u003csummary style=\"cursor: pointer;\"\u003e\n    \u003ch3 style=\"display: inline; color: #0366d6;\"\u003e🎥 Click to watch a Demo!\u003c/h3\u003e\n  \u003c/summary\u003e\n  \u003cbr\u003e\n  \u003cdiv align=\"center\"\u003e\n    \u003cvideo src=\"https://github.com/user-attachments/assets/cd984f3d-0ba8-4590-9645-99f2b5e980b6\" width=\"100%\" controls autoplay muted loop\u003e\n    \u003c/video\u003e\n  \u003c/div\u003e\n\u003c/details\u003e\n\n---\n\n## Explore BikeScout\n\n* **[User Guide](https://hifly81.github.io/bikescout/documentation/index.html)** Detailed API references and step-by-step guides to deploy the BikeScout.\n\n* **[Website](https://hifly81.github.io/bikescout)** Explore the visual breakdown of Mud Logic, S-Scale terrain grading, and how we transform raw OSM data into mission-ready intel. Check the latest race analysis reports from the legendary routes.\n\n**Love BikeScout?** ⭐ Star this repo to support the development of the first open-source tactical cycling engine.\n\n**Found a bug?** Open an Issue. Want to add a local skill? PRs are welcome!\n\n---\n\n## Example Queries\n\nYou can ask **BikeScout** complex, multi-step requests. It combines real-time data with technical cycling intelligence to provide expert-level answers.\n\n### 🗺️ Advanced Planning (Multi-Tool)\n* *\"I'm at Monte Cavo with my MTB bike (29 tires). Plan a 25km loop for me. Check if the terrain is compatible with my bike, verify the afternoon rain probability, and suggest a 'Fraschetta' for the finish. Use the Castelli Romani guide.\"*\n\n### ⚙️ Bike Setup \u0026 Surface Intelligence\n* *\"Check this route from Barcelona city center to El Prat. I'm on a Road Bike with 25mm tires. Is it compatible? Give me the exact percentage of gravel vs asphalt.\"*\n\n### 📈 Visual Elevation \u0026 Gradient Analysis\n* *\"Plan a 40km route starting from Bormio. I need the Visual Elevation Profile to see the exact gradients of the Stelvio climb. Highlight sections over 12% so I can manage my pacing.\"*\n\n### 🏔️ Local Expertise\n* *\"Use the Derby local guide to plan a road cycling route starting from Derby. I need at least 800m of elevation gain. Also, recommend the correct tire pressure for high-altitude descents.\"*\n\n### 🛠️ Quick Tech Checks\n* *\"Give me the safety checklist and calculate the tire pressure for a 90kg rider on 2.3\" tubeless tires for a muddy ride.\"*\n\n### 🏁 Post-Ride Analysis \u0026 Terrain Truth\n* *\"Analyze my ride from 2026-04-12. Compare my average speed with the Mud Risk at that time and tell me if the terrain conditions were the reason for my slow pace.\"*\n\n---\n\n## 🤝 Contributing\n\nContributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make to **BikeScout** are **greatly appreciated**.\n\n### How to Contribute\n\n1. **Report Bugs**: Found a glitch? Open an [Issue](https://github.com/yourusername/bikescout/issues) with a detailed description and steps to reproduce.\n2. **Feature Requests**: Have an idea to make BikeScout better? Open an issue to discuss it!\n3. **Pull Requests**:\n   - Fork the Project.\n   - Create your Feature Branch (`git checkout -b feature/AmazingFeature`).\n   - Commit your changes (`git commit -m 'Add some AmazingFeature'`).\n   - Push to the Branch (`git checkout origin feature/AmazingFeature`).\n   - Open a Pull Request.\n\n### Coding Standards\n- Please follow [PEP 8](https://peps.python.org/pep-0008/) for Python code.\n- Ensure all new tools are documented in the `README.md`.\n- Keep comments in English for international collaboration.\n\n*By contributing, you agree that your contributions will be licensed under the project's AGPLv3 License.*\n\n---\n\n## License \u0026 Data Attributions\n\n### Software License\nThis project is licensed under the **GNU Affero General Public License v3.0 (AGPL-3.0)** - see the [LICENSE](LICENSE) file for details.\n\n#### Why AGPLv3? \nBikeScout contains proprietary-grade tactical logic (such as the TAEL® Mud Reservoir Model). The AGPLv3 ensures that:\n- Transparency: Any modified version of BikeScout used to provide a service over a network (SaaS/Cloud) must make its full source code available to the community.\n- Integrity: The core tactical intelligence remains open and collaborative, preventing \"closed-source\" commercial hijacking of the platform's unique algorithms.\n\n### Data Sources \u0026 Credits\nBikeScout aggregates data from several open providers. Users of this server must adhere to their respective terms:\n\n* **Routing \u0026 Map Data:** Provided by [OpenRouteService](https://openrouteservice.org/) by HeiGIT.\n* **Geospatial \u0026 Geocoding Data:** © [OpenStreetMap](https://www.openstreetmap.org/copyright) contributors. Data is available under the [Open Database License (ODbL)](https://opendatacommons.org/licenses/odbl/). Geocoding service powered by [Nominatim](https://nominatim.org/).\n* **Weather Forecasts:** Powered by [Open-Meteo](https://open-meteo.com/). Data is licensed under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhifly81%2Fbikescout","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhifly81%2Fbikescout","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhifly81%2Fbikescout/lists"}