{"id":49763455,"url":"https://github.com/dodbrian/osmaps-mcp","last_synced_at":"2026-05-11T10:06:40.450Z","repository":{"id":351305202,"uuid":"1180241994","full_name":"dodbrian/osmaps-mcp","owner":"dodbrian","description":"MCP server for calculating route distances and travel times using free OpenStreetMap services","archived":false,"fork":false,"pushed_at":"2026-04-14T12:18:00.000Z","size":218,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-14T14:18:29.455Z","etag":null,"topics":["maps","mcp","mcp-server","nominatim","osrm"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/dodbrian.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":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-03-12T21:05:29.000Z","updated_at":"2026-04-14T12:18:13.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/dodbrian/osmaps-mcp","commit_stats":null,"previous_names":["dodbrian/osmaps-mcp"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/dodbrian/osmaps-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dodbrian%2Fosmaps-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dodbrian%2Fosmaps-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dodbrian%2Fosmaps-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dodbrian%2Fosmaps-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dodbrian","download_url":"https://codeload.github.com/dodbrian/osmaps-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dodbrian%2Fosmaps-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32890014,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-10T13:40:02.631Z","status":"online","status_checked_at":"2026-05-11T02:00:05.975Z","response_time":120,"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":["maps","mcp","mcp-server","nominatim","osrm"],"created_at":"2026-05-11T10:06:39.641Z","updated_at":"2026-05-11T10:06:40.444Z","avatar_url":"https://github.com/dodbrian.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# osmaps-mcp\n\nMCP server for route distance calculations using OSRM and Nominatim.\n\n## Features\n\n- **Route Distance**: Calculate driving distance and travel time between two locations\n- **Geocoding**: Converts addresses to coordinates using Nominatim (OpenStreetMap)\n- **Coordinate Support**: Accepts both addresses and lat,lng coordinates\n- **No API Key Required**: Uses free OpenStreetMap services\n\n## Requirements\n\n- Node.js 18+\n\n## Installation\n\n```bash\nnpm install\nnpm run setup\n```\n\nThis builds the project and links the `osmaps-mcp` binary globally.\n\n## Configuration\n\nAfter running `npm run setup`, configure your MCP client to use `osmaps-mcp`:\n\n### Claude Desktop\n\nAdd to your Claude Desktop configuration file:\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"osmaps\": {\n      \"command\": \"osmaps-mcp\"\n    }\n  }\n}\n```\n\n### Claude Code\n\nAdd via CLI:\n\n```bash\nclaude mcp add --transport stdio osmaps -- osmaps-mcp\n```\n\nOr add to `~/.claude.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"osmaps\": {\n      \"command\": \"osmaps-mcp\"\n    }\n  }\n}\n```\n\n### Cursor\n\nCreate `.cursor/mcp.json` in your project root:\n\n```json\n{\n  \"mcpServers\": {\n    \"osmaps\": {\n      \"command\": \"osmaps-mcp\"\n    }\n  }\n}\n```\n\n### Windsurf\n\nAdd to your Windsurf MCP configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"osmaps\": {\n      \"command\": \"osmaps-mcp\"\n    }\n  }\n}\n```\n\n### OpenCode\n\nAdd to your `opencode.json` config file:\n\n```json\n{\n  \"$schema\": \"https://opencode.ai/config.json\",\n  \"mcp\": {\n    \"osmaps\": {\n      \"type\": \"local\",\n      \"command\": [\"osmaps-mcp\"],\n      \"enabled\": true\n    }\n  }\n}\n```\n\n### Gemini CLI\n\nAdd via CLI:\n\n```bash\ngemini mcp add osmaps osmaps-mcp -t stdio\n```\n\nOr add to your Gemini CLI configuration file:\n\n```json\n{\n  \"mcpServers\": {\n    \"osmaps\": {\n      \"command\": \"osmaps-mcp\"\n    }\n  }\n}\n```\n\n## Tools\n\n### get-route-distance\n\nCalculate driving route distance and travel time between two locations.\n\n**Parameters:**\n- `origin` - Starting location (address or lat,lng coordinates)\n- `destination` - Ending location (address or lat,lng coordinates)\n\n**Example:**\n```\norigin: \"Berlin, Germany\"\ndestination: \"Paris, France\"\n```\nReturns: `452.31 km, 265 min`\n\n**Coordinate example:**\n```\norigin: \"52.5200,13.4050\"\ndestination: \"48.8566,2.3522\"\n```\n\n## APIs Used\n\n- [OSRM](http://router.project-osrm.org/) - Open Source Routing Machine (free, no API key)\n- [Nominatim](https://nominatim.openstreetmap.org/) - OpenStreetMap geocoding (free, no API key)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdodbrian%2Fosmaps-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdodbrian%2Fosmaps-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdodbrian%2Fosmaps-mcp/lists"}