Skip to main content
Glama

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-mcp

Claude 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_query

원시 Overpass QL 쿼리를 실행합니다. 헬퍼가 너무 좁을 때 사용하는 탈출구입니다.

find_nearby

지점 반경 내에서 태그 필터와 일치하는 피처를 찾습니다.

features_in_bbox

경계 상자 내에서 태그 필터와 일치하는 피처를 찾습니다.

count_features

영역 내 일치 항목을 반환하지 않고 계산합니다. 저렴합니다. 데이터를 가져오기 전에 사용하세요.

get_usage

키의 등급, 한도, 월간 사용량 및 최근 요청을 확인합니다. 할당량을 소비하지 않습니다.

서버는 또한 모델이 읽을 수 있는 두 가지 리소스(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_KEY

예

Overspan API 키

OVERSPAN_API_URL

아니요

https://api.overspan.dev

API 엔드포인트 재정의

OVERSPAN_MAX_RESPONSE_CHARS

아니요

48000

도구 결과의 잘림 임계값

데이터 라이선스

결과는 Open Database License에 따라 라이선스가 부여된 OpenStreetMap 데이터입니다. 이 데이터를 표시하거나 파생하는 모든 게시물에는 openstreetmap.org/copyright에 도달하는 눈에 띄는 크레딧이 필요합니다. Overspan 구독은 데이터가 아닌 호스팅 및 액세스 비용을 지불하며, 이러한 의무를 변경하지 않습니다.

개발

npm install
npm run build
npm test

테스트 스위트는 쿼리 빌더, 응답 형성, 오류 매핑 및 전체 인메모리 MCP 클라이언트 왕복을 다룹니다.

링크

Overspan은 독립 서비스이며 OpenStreetMap 재단 또는 Overpass API 프로젝트와 제휴하지 않습니다.

MIT 라이선스.

Available Tools

5 tools
count_featuresCount matching featuresA
Read-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 boxA
Read-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 pointA
Read-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 limitsA
Read-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 QLA
Read-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

    A4.2/5.0

    Scored across 5 tools

    Disambiguation4/5

    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.

    Naming Consistency3/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP 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.
      7
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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 npm
      MIT