overspan-mcp
overspan-mcp
Overspan용 MCP(Model Context Protocol) 서버로, 호스팅된 Overpass API입니다. Claude, Cursor 및 기타 모든 MCP 클라이언트에 전체 행성 OpenStreetMap 데이터에 대한 직접적이고 계량된 액세스를 제공합니다: 원시 Overpass QL과 근처 검색, 경계 상자 검색, 카운팅 및 사용량 확인을 위한 헬퍼 도구가 포함됩니다.
Overspan API 키가 필요합니다. 요금제는 overspan.dev에서 월 $19부터 시작합니다. 결제 후 이메일로 키가 도착하며, 계정은 필요 없습니다.
빠른 시작
Claude Code
claude mcp add overspan --env OVERSPAN_API_KEY=YOUR_KEY -- npx -y overspan-mcpClaude Desktop, Cursor 및 기타 JSON 구성 클라이언트
{
"mcpServers": {
"overspan": {
"command": "npx",
"args": ["-y", "overspan-mcp"],
"env": {
"OVERSPAN_API_KEY": "YOUR_KEY"
}
}
}
}키는 서버의 env 블록에 있어야 합니다. MCP 클라이언트는 자체 환경으로 서버를 시작하므로 셸 프로필에서 내보낸 변수는 서버에 도달하지 않습니다. 키가 포함된 구성 파일은 비밀로 취급하세요. Claude Code의 .mcp.json에서는 "OVERSPAN_API_KEY": "${OVERSPAN_KEY}"로 작성하여 키를 환경에 유지하고 파일에서 제외할 수 있습니다.
Related MCP server: @cyanheads/openstreetmap-mcp-server
도구
도구 | 기능 |
| 원시 Overpass QL 쿼리를 실행합니다. 헬퍼가 너무 좁을 때 사용하는 탈출구입니다. |
| 지점 반경 내에서 태그 필터와 일치하는 피처를 찾습니다. |
| 경계 상자 내에서 태그 필터와 일치하는 피처를 찾습니다. |
| 영역 내 일치 항목을 반환하지 않고 계산합니다. 저렴합니다. 데이터를 가져오기 전에 사용하세요. |
| 키의 등급, 한도, 월간 사용량 및 최근 요청을 확인합니다. 할당량을 소비하지 않습니다. |
서버는 또한 모델이 읽을 수 있는 두 가지 리소스(overspan://overpass-ql, QL 치트 시트, overspan://differences, Overspan이 공개 서버와 다른 점)와 하나의 프롬프트(write-bounded-overpass-query)를 노출합니다.
알아두면 좋은 동작
키는
Authorization: Bearer헤더로 전송되며, URL에는 절대 포함되지 않습니다.모든 성공적인 도구 결과에는 할당량 줄(
[quota] 49998 of 50000 monthly requests remaining)이 포함되어 에이전트가 속도를 조절할 수 있습니다.get_usage는 전체 그림을 제공하며 호출 비용이 없습니다.오류는 게이트웨이의 오류 코드, 의미, 재시도 여부와 함께 평이한 언어로 반환됩니다. 거부된 요청은 할당량을 소비하지 않으며, 폭주 루프는 키 자체의 속도 및 동시성 제한에 의해 제한되며 더 큰 청구서로 제한되지 않습니다.
과도하게 큰 응답은 모델의 컨텍스트에 맞게 잘립니다: Overpass JSON의 경우 요소 목록이 잘리고 결과에 얼마나 많은 요소가 삭제되었는지 표시됩니다. 더 많은 데이터를 원하면
OVERSPAN_MAX_RESPONSE_CHARS로 상한을 높이세요.[timeout:]이 없는 쿼리는 25초를 받습니다. 무거운 쿼리의 경우 등급의 상한까지 명시적으로 설정하세요.
환경 변수
변수 | 필수 | 기본값 | 목적 |
| 예 | Overspan API 키 | |
| 아니요 |
| API 엔드포인트 재정의 |
| 아니요 |
| 도구 결과의 잘림 임계값 |
데이터 라이선스
결과는 Open Database License에 따라 라이선스가 부여된 OpenStreetMap 데이터입니다. 이 데이터를 표시하거나 파생하는 모든 게시물에는 openstreetmap.org/copyright에 도달하는 눈에 띄는 크레딧이 필요합니다. Overspan 구독은 데이터가 아닌 호스팅 및 액세스 비용을 지불하며, 이러한 의무를 변경하지 않습니다.
개발
npm install
npm run build
npm test테스트 스위트는 쿼리 빌더, 응답 형성, 오류 매핑 및 전체 인메모리 MCP 클라이언트 왕복을 다룹니다.
링크
Overspan은 독립 서비스이며 OpenStreetMap 재단 또는 Overpass API 프로젝트와 제휴하지 않습니다.
MIT 라이선스.
Available Tools
5 toolscount_featuresCount matching featuresARead-only
Count OpenStreetMap features matching tag filters in an area without returning them. Cheap. Use this before pulling data when the result size is unknown. Give either a point (lat, lon, radius_m) or a bounding box (south, west, north, east).
Inputs: tags (required), lat, lon, east, +4 more.
features_in_bboxFind features in a bounding boxARead-only
Find OpenStreetMap features matching tag filters inside a bounding box (south, west, north, east in decimal degrees). Returns up to 'limit' elements with their tags and a centre coordinate. Keep boxes small; for city-sized areas call count_features first.
Inputs: east (required), tags (required), west (required), north (required), +2 more.
find_nearbyFind features near a pointARead-only
Find OpenStreetMap features matching tag filters within a radius of a point. Returns up to 'limit' elements with their tags and a centre coordinate. Good first tool for questions like 'what cafes are near X'. For larger or unknown result sets, call count_features first.
Inputs: lat (required), lon (required), tags (required), limit, +1 more.
get_usageCheck Overspan usage and limitsARead-only
Check this API key's tier, its limits, month-to-date quota, and recent request history. Does not consume query quota. Use it to pace yourself when running many queries.
Inputs: no named parameters.
overpass_queryRun raw Overpass QLARead-only
Run a raw Overpass QL query against the Overspan hosted Overpass API (full-planet OpenStreetMap data, minutes behind live). Use this when the helper tools are too narrow. Always bound the query to an area and cap the output (for example: out center 25;). Start with [out:json]. Queries without [timeout:] get 25 seconds. Read the overspan://overpass-ql resource for syntax and the overspan://differences resource for how this server differs from the public ones.
Inputs: query (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
find_nearby and features_in_bbox both fetch OSM features by location, but their radius-vs-bounding-box distinction is clearly explained and they cover different query shapes. overpass_query, count_features, and get_usage are each clearly separate from the helpers and from each other.
Most names use lowercase snake_case, but the conventions vary: overpass_query and features_in_bbox are noun-like, while find_nearby, count_features, and get_usage are verb-led. None are confusing, but there is no single predictable verb_noun pattern across the set.
Five tools is well-scoped for an Overpass API server: one raw query escape hatch, two standard spatial search helpers, a counting tool for sizing result sets, and a usage-monitoring tool. Each tool has a distinct role and none feel redundant.
The tool surface covers the core workflow well: count before pulling data, query by point or bounding box, and fall back to a raw Overpass query when helpers are too narrow. get_usage also covers the operational side of the hosted API, so there are no obvious dead ends.
Maintenance
Related MCP Connectors
OpenStreetMap Overpass MCP — programmatic queries against the OSM database
Query OpenStreetMap with Overpass QL, find water and food stops along routes, and check weather at arrival time. Free API key: 500 requests/day, including commercial use. [Setup and examples](https://geo.runningcat.dev/mcp?utm_source=glama&utm_medium=referral&utm_campaign=mcp_directory).
Geocoding, static maps and privacy-safe area maps from OpenStreetMap data. Hard caps, no overage.
Geocode, reverse geocode, and run Overpass spatial queries on OpenStreetMap data.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables programmatic queries against the OpenStreetMap database using the Overpass API.121 npmMIT
- AlicenseNot gradedqualityAmaintenanceGeocode, reverse geocode, and run Overpass spatial queries on OpenStreetMap data via MCP.802 npm9Apache 2.0
- AlicenseAqualityDmaintenanceMCP server providing structured access to OpenStreetMap data through Overpass and Nominatim APIs, enabling geocoding, nearby place searches, element queries, and tag counting without API keys.7MIT
- AlicenseNot gradedqualityCmaintenanceEnables desktop agents and clients to access geospatial services via a hosted MCP server, including OpenStreetMap queries, address and business search, POI discovery, routing, matrices, isochrones, map matching, optimization, elevation and terrain, basemap styling, spatial analysis, rendering, usage, and service status.32 npmMIT