M
Marc-Armillas/bicycle-routes-generator-mcp
MCP server for Claude that generates mountain bike and road cycling routes (loops, point-to-point, via points) on real OpenStreetMap data and saves them as GPX with elevation and safety warnings.
no SECURITY.md
View on GitHub ↗Link checked 2026-11-12 · HTTP 200 · opens the vendor's own site
Install & config
Client config (built from the install command this repo gives)
{
"mcpServers": {
"marc-armillas-bicycle-routes-generator-m": {
"command": "npx",
"args": ["@anthropic-ai/mcpb"]
}
}
}Parsed from the README we fetched on 2026-10-26; we have not executed it.
command/args come from the install command the repository states. When it is ambiguous, the project README wins.
VS Code (.vscode/mcp.json - the key is servers)
{
"servers": {
"marc-armillas-bicycle-routes-generator-m": {
"command": "npx",
"args": ["@anthropic-ai/mcpb"]
}
}
}Same server, but VS Code keeps it under <code>servers</code>.
Claude Code (command line)
claude mcp add --transport stdio marc-armillas-bicycle-routes-generator-m -- npx @anthropic-ai/mcpb
Claude Code does not read a config file; add the server with this command.
Key names differ by client: Clients & CLI
- Star count
- 0 ★ · Marc-Armillas/bicycle-routes-generator-mcp · read from the GitHub search API · (checked 2026-11-13 20:00:50)
- Source
- collected from the punkpeye/awesome-mcp-servers list · type: MCP server
- Harvest history
- first seen 2026-10-23 · last seen 2026-11-14 · seen 26× · listed by 23 sources
- Score
- score 2,300 · 23 sources · mcp
- Install
npx @anthropic-ai/mcpb
FAQ (answers come from our records)
How do I install it?
The repository provides this install command:
npx @anthropic-ai/mcpb. It comes from the repository itself; we cannot guarantee it runs as-is in your client.Who is it for?
We filed it under these tags: MCP 服务. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
Marc-Armillas/bicycle-routes-generator-mcp；first catalogued 2026-10-23；last seen 2026-11-14。There is no official certification or quality rating here — we record sources and dates only.# Bicycle routes generator MCP
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
English · Español
⬇️ Download the Claude Desktop extension (bicycle-routes-generator-mcp.mcpb)
Generates mountain bike and road cycling routes from a location and saves them as
GPX with elevation. The track is computed by a routing engine (BRouter or
OpenRouteService) on real OpenStreetMap trails and roads: neither the AI nor the
application invents coordinates.
You can use it:
With Claude (Claude Desktop or Claude Code) through a local MCP server: "make me a
~25 km MTB loop from Casa de Campo in Madrid, little climbing, on dirt tracks" (see
what happens when you ask Claude).
From the terminal, without AI: bicycle-routes generate "Casa de Campo, Madrid" --km 25 --type tracks.
Every route comes with a summary (distance, climbing, maximum grade, % of pavement, dirt
track and singletrack) and warnings: sections with motor traffic, grades over 12 %,
protected areas, ways where bikes are not allowed and technical sections.
> 💾 GPX files go to /tmp/bicycle-routes by default. macOS empties /tmp on restart and cleans
> up old files, so copy the routes you want to keep (or set BIKEGPXDIR to another folder).
> ⚠️ Always check the route on a map before riding. OpenStreetMap data may be incomplete
> or out of date, and does not reflect temporary closures or every local regulation. Climbing
> is computed from a digital elevation model (~90 m) and may differ from what a barometric
> watch or bike computer records (often by 10-20 %); short ramps may be smoothed out.
## Easy install in Claude Desktop (.mcpb extension)
1. Download bicycle-routes-generator-mcp.mcpb (always the latest release), or build it with
npx @anthropic-ai/mcpb pack . dist/bicycle-routes-generator-mcp.mcpb.
2. Double-click the file (or drag it into Claude Desktop → Settings → Extensions) and click
Install.
3. Fill in the configuration: the GPX folder (/tmp/bicycle-routes by default) and a contact email
(required by the OpenStreetMap/Nominatim usage policy). The other fields are optional.
4. Ask Claude: "make me a 25 km MTB loop from Casa de Campo in Madrid on dirt tracks".
No need to install Python: this is a uv extension, so Claude Desktop downloads Python and the
dependencies automatically the first time (it can take a minute). .mcpb is the successor of
the .dxt format; older Claude Desktop versions that only support .dxt cannot run uv
extensions.
## Manual install (CLI and Claude Code)
Requirements: macOS, Windows or Linux with uv (it installs Python for you).
bash
git clone bicycle-routes-generator-mcp
cd bicycle-routes-generator-mcp
uv sync
cp .env.example .env # and edit it
### Configuration (environment variables)
There are no keys or personal data in the code: everything is configured through environment
variables (or a .env file in the folder you run the CLI from).
| Variable | Default | Purpose |
| BIKEGPXDIR | /tmp/bicycle-routes | Folder where GPX files are saved. The app only writes here (and to its .bicycle-routes/ subfolder with cache and index). On Windows the default is the system temp folder. |
| BIKECONTACT | — | Email or URL sent in the User-Agent. Recommended: required by Nominatim's policy. |
| BIKEENGINE | brouter | brouter or ors. |
⬇️ Download the Claude Desktop extension (bicycle-routes-generator-mcp.mcpb)
Generates mountain bike and road cycling routes from a location and saves them as
GPX with elevation. The track is computed by a routing engine (BRouter or
OpenRouteService) on real OpenStreetMap trails and roads: neither the AI nor the
application invents coordinates.
You can use it:
With Claude (Claude Desktop or Claude Code) through a local MCP server: "make me a
~25 km MTB loop from Casa de Campo in Madrid, little climbing, on dirt tracks" (see
what happens when you ask Claude).
From the terminal, without AI: bicycle-routes generate "Casa de Campo, Madrid" --km 25 --type tracks.
Every route comes with a summary (distance, climbing, maximum grade, % of pavement, dirt
track and singletrack) and warnings: sections with motor traffic, grades over 12 %,
protected areas, ways where bikes are not allowed and technical sections.
> 💾 GPX files go to /tmp/bicycle-routes by default. macOS empties /tmp on restart and cleans
> up old files, so copy the routes you want to keep (or set BIKEGPXDIR to another folder).
> ⚠️ Always check the route on a map before riding. OpenStreetMap data may be incomplete
> or out of date, and does not reflect temporary closures or every local regulation. Climbing
> is computed from a digital elevation model (~90 m) and may differ from what a barometric
> watch or bike computer records (often by 10-20 %); short ramps may be smoothed out.
## Easy install in Claude Desktop (.mcpb extension)
1. Download bicycle-routes-generator-mcp.mcpb (always the latest release), or build it with
npx @anthropic-ai/mcpb pack . dist/bicycle-routes-generator-mcp.mcpb.
2. Double-click the file (or drag it into Claude Desktop → Settings → Extensions) and click
Install.
3. Fill in the configuration: the GPX folder (/tmp/bicycle-routes by default) and a contact email
(required by the OpenStreetMap/Nominatim usage policy). The other fields are optional.
4. Ask Claude: "make me a 25 km MTB loop from Casa de Campo in Madrid on dirt tracks".
No need to install Python: this is a uv extension, so Claude Desktop downloads Python and the
dependencies automatically the first time (it can take a minute). .mcpb is the successor of
the .dxt format; older Claude Desktop versions that only support .dxt cannot run uv
extensions.
## Manual install (CLI and Claude Code)
Requirements: macOS, Windows or Linux with uv (it installs Python for you).
bash
git clone bicycle-routes-generator-mcp
cd bicycle-routes-generator-mcp
uv sync
cp .env.example .env # and edit it
### Configuration (environment variables)
There are no keys or personal data in the code: everything is configured through environment
variables (or a .env file in the folder you run the CLI from).
| Variable | Default | Purpose |
| BIKEGPXDIR | /tmp/bicycle-routes | Folder where GPX files are saved. The app only writes here (and to its .bicycle-routes/ subfolder with cache and index). On Windows the default is the system temp folder. |
| BIKECONTACT | — | Email or URL sent in the User-Agent. Recommended: required by Nominatim's policy. |
| BIKEENGINE | brouter | brouter or ors. |
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/marc-armillas-bicycle-routes-generator-mcp/)
- Source
- awesome · https://github.com/Marc-Armillas/bicycle-routes-generator-mcp
- Browse by field
- MCP servers
- Listed by
- 23 independent sources
- added
- today
- Security policy
- no
SECURITY.mdat the repository root (which does not mean it is unsafe)
More like this
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.