Bicycle routes generator MCP
Generate MTB and road cycling routes on OpenStreetMap trails as GPX with safety warnings
- Platforms
- macOS, Windows, Linux
- Runs
- Locally
- Version
- 0.5.0
- Listing updated
- today
Similar MCP servers
About Bicycle routes generator MCP
Bicycle routes generator MCP is an MCP server for maps and travel. It runs locally on your machine and is started by your AI client.
The tool never lets the model make up coordinates. A routing engine, BRouter by default or OpenRouteService with a free key, computes the track on real OpenStreetMap trails and roads. Given a start place, a distance and optional limits on climbing and trail type, it creates six candidate loops, scores them on distance, traffic, repeated trails, surface, forbidden access and climbing, keeps the best one and saves a GPX file with elevation.
Each route comes with a summary of distance, climbing, maximum grade and the share of pavement, dirt track and singletrack, plus warnings about stretches with motor traffic, grades above 12 percent, protected areas, ways closed to bikes and technical sections. Trail types are tracks, mixed, singletrack and road, and routes can be loops, point to point or forced through via points. A seed makes a result reproducible.
The author cautions to check every route on a map, since OpenStreetMap data can be out of date and the elevation model has about 90 m resolution, so climbing may differ by 10 to 20 percent from a bike computer. It runs locally as a Claude Desktop extension or from the command line with uv.
Install
Run in a terminal
claude mcp add bicycle-routes-generator-mcp -- npx -y https://github.com/Marc-Armillas/bicycle-routes-generator-mcp/releases/download/v0.5.0/bicycle-routes-generator-mcp.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"bicycle-routes-generator-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/Marc-Armillas/bicycle-routes-generator-mcp/releases/download/v0.5.0/bicycle-routes-generator-mcp.mcpb"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"bicycle-routes-generator-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/Marc-Armillas/bicycle-routes-generator-mcp/releases/download/v0.5.0/bicycle-routes-generator-mcp.mcpb"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"bicycle-routes-generator-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/Marc-Armillas/bicycle-routes-generator-mcp/releases/download/v0.5.0/bicycle-routes-generator-mcp.mcpb"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"bicycle-routes-generator-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/Marc-Armillas/bicycle-routes-generator-mcp/releases/download/v0.5.0/bicycle-routes-generator-mcp.mcpb"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"bicycle-routes-generator-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/Marc-Armillas/bicycle-routes-generator-mcp/releases/download/v0.5.0/bicycle-routes-generator-mcp.mcpb"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- generate_route
- Generate a route from a start place and distance, returning the GPX path, summary and warnings.
- list_routes
- List saved routes.
What it does
- Real-trail routing
- Uses BRouter or OpenRouteService on OpenStreetMap data.
- GPX with elevation
- Saves routes as GPX files in a folder you choose.
- Route summary
- Reports distance, climbing, grades and surface mix.
- Safety warnings
- Flags traffic, steep grades, protected areas and restricted ways.
- Trail types
- Offers tracks, mixed, singletrack and road modes.
- Via points and seeds
- Routes through chosen places and can reproduce a result.
Good for
- Plan a 25 km MTB loop on dirt tracks from a city park
- Make a road-bike route with little traffic
- Create a point-to-point ride between two towns
- Export a GPX for a bike computer
Pricing
Pricing unknown
Licence not stated in the README; uses free public routing services
Bicycle routes generator MCP FAQ
Does the AI invent coordinates?
No, the track is computed by a routing engine on OpenStreetMap data.
Where are GPX files saved?
In /tmp/bicycle-routes by default, which can be changed.
Do I need an API key?
Not for the default BRouter engine; OpenRouteService needs a free key.
How accurate is climbing?
It comes from a ~90 m elevation model and may differ 10 to 20 percent from a bike computer.
How do I add Bicycle routes generator MCP to Claude Code?
Run this command in your terminal: claude mcp add bicycle-routes-generator-mcp -- npx -y https://github.com/Marc-Armillas/bicycle-routes-generator-mcp/releases/download/v0.5.0/bicycle-routes-generator-mcp.mcpb
What are the best alternatives to Bicycle routes generator MCP?
The closest alternatives to Bicycle routes generator MCP are Atli, CAD2GIS, Coordinates, Photon and Travel Advisories.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.
