geolabel-mcp
GeoLabel MCP 서버
GPS 좌표를 AI가 이해할 수 있는 위치 정보로 변환하세요 — Claude Desktop, Claude Code 및 모든 MCP 호환 어시스턴트용입니다.
기능
좌표를 보내면 장소 이름, 카테고리 및 실시간 영업 시간을 반환합니다:
{
"label": "Walmart",
"category": "supermarket",
"is_open": true,
"closes_at": "23:00",
"opening_hours": "Mo-Su 06:00-23:00"
}이제 Claude가 다음과 같이 답변할 수 있습니다: *"당신은 47분 후에 문을 닫는 월마트에 있습니다."
Related MCP server: Geo MCP Worker
빠른 설정
1. GeoLabel API 키 받기
geolabel.dev에서 무료로 받으세요 — 하루 100회 요청 가능, 신용카드 불필요.
2. 에이전트에 추가
아래에서 클라이언트를 선택하세요.
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json 파일을 편집하세요:
{
"mcpServers": {
"geolabel": {
"command": "uvx",
"args": ["geolabel-mcp"],
"env": {
"GEOLABEL_API_KEY": "glk_your_key_here"
}
}
}
}Claude Desktop을 재시작하세요. 도구 목록에 GeoLabel 도구가 나타납니다.
Claude Code
claude mcp add geolabel -- uvx geolabel-mcp
export GEOLABEL_API_KEY=glk_your_key_hereHermes Agent
~/.hermes/config.json 파일을 편집하세요:
{
"mcpServers": {
"geolabel": {
"command": "uvx",
"args": ["geolabel-mcp"],
"env": {
"GEOLABEL_API_KEY": "glk_your_key_here"
}
}
}
}자세한 내용은 Hermes Agent MCP 문서를 참조하세요.
OpenClaw
# Register the server
openclaw mcp set geolabel \
--command uvx \
--args geolabel-mcp \
--env GEOLABEL_API_KEY=glk_your_key_here
# Verify it's registered
openclaw mcp list자세한 내용은 OpenClaw MCP 문서를 참조하세요.
3. 사용 방법
You: I'm at 41.8827, -87.6233 — what's here and is it open?
Agent: You're at Planet Fitness (a gym). It's currently open and closes
at 11:00 PM tonight — you have about 3 hours left.도구
get_location_label
주어진 좌표의 radius 미터 이내에서 가장 가까운 장소를 식별합니다.
매개변수 | 유형 | 기본값 | 설명 |
| float | 필수 | 위도 (-90 ~ 90) |
| float | 필수 | 경도 (-180 ~ 180) |
| int | 100 | 검색 반경 (미터 단위, 최대 500) |
응답 필드:
필드 | 유형 | 설명 | |
| string | null | OpenStreetMap의 원본 장소 이름 |
| string | 깔끔하게 정리된 표시용 이름 | |
| string | null | 고정된 유형: |
| float | null | 좌표에서 장소까지의 거리 |
| bool | null |
|
| string | null | 다음 영업 시작 시간 |
| string | null | 오늘의 영업 종료 시간 |
| string | null | 원본 OSM |
| bool | 10분 캐시에서 제공됨; 영업 시간은 항상 실시간으로 재계산됨 |
대체 설치 방법
# pip
pip install geolabel-mcp
# run directly
GEOLABEL_API_KEY=glk_xxx geolabel-mcpClaude Code
claude mcp add geolabel -- uvx geolabel-mcp그런 다음 키를 설정하세요:
# add to your shell profile or .env
export GEOLABEL_API_KEY=glk_your_key_here구성
변수 | 필수 | 설명 |
| 예 | GeoLabel API 키 |
| 아니요 | API 기본 URL 재정의 (기본값: |
개인정보 보호
GeoLabel은 모든 서버 로그가 디스크에 기록되기 전에 좌표를 삭제합니다. 이동 기록은 저장되지 않습니다. 데이터는 실시간으로 처리되며 즉시 폐기됩니다. 전체 개인정보 보호정책 →
라이선스
MIT
Available Tools
1 toolget_location_labelA
Identify a place from GPS coordinates and return its label, category, and live opening-hours status.
Use this whenever the user provides coordinates or asks what is at a location. The response gives Claude everything needed to answer location-aware questions — place name, type, whether it is open right now, and when it closes or next opens.
Args: lat: Latitude in decimal degrees (-90 to 90). lng: Longitude in decimal degrees (-180 to 180). radius: Search radius in metres. Smaller values pin to the nearest place precisely; larger values cast a wider net. Default 100 m, maximum 500 m.
Returns a dict with: place Raw venue name from OpenStreetMap (may include branch numbers or location suffixes). Prefer 'label' for display. label Clean, user-friendly name — e.g. "Walmart", "Planet Fitness", "Starbucks". Use this for display and speech. category Stable place type for logic: "gym", "supermarket", "restaurant", "fast_food", "gas_station", "pharmacy", "hospital", "cafe", "retail", etc. distance_meters Distance in metres from the supplied coordinates to the matched place centroid. is_open true → currently open. false → currently closed. null → OpenStreetMap has no hours data for this place. opens_at Next opening time as "HH:MM" (24-hour). Populated when is_open is false so you know when it reopens. null when open, or when hours are unknown. closes_at Today's closing time as "HH:MM" (24-hour). Populated when is_open is true — subtract current time to get minutes remaining. null when closed or hours unknown. opening_hours Raw OpenStreetMap opening_hours string, e.g. "Mo-Fr 09:00-18:00; Sa 10:00-17:00". null if not set in OSM. cached true if place data was served from the 10-minute in-memory cache. Hours fields are always recalculated live against the current time, even on cache hits.
Inputs: lat (required), lng (required), radius.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
Only one tool exists, so there is no possibility of confusion between tools. The single tool's purpose is clearly defined.
With only one tool, naming consistency is inherently perfect. The name 'get_location_label' follows a clear verb_noun pattern.
A single tool is at the low end of typical scope. It serves a focused purpose (geolocation labeling), but the server feels thin for a full MCP surface.
The tool provides rich detail (name, category, hours, distance) for its single operation. Lacks additional geolocation utilities like batch or address lookup, but core need is met.
Related MCP Connectors
Worldwide place search with coordinates (Open-Meteo) — paid per call (x402/credits), 1 tools
Unofficial Nominatim MCP — wraps OpenStreetMap Nominatim geocoding API (free, no auth)
Location tools for Claude and other MCP clients, strongest in the US and Great Britain. Geocode whole lists with a confidence score per row, filter by distance, get road distances and drive-time areas, and plan multi-driver routes with Google Maps links. Check flood zones, crime and live warnings, find nearby places and UK registers (NHS, CQC, food hygiene), and keep shareable maps. Reads and writes Google Sheets. Free: sign in with Google.
Address to coordinates and back, postal codes, worldwide (OpenStreetMap). Free, no key.
Related MCP Servers
- AlicenseBqualityAmaintenanceEnables AI assistants to search, validate, and edit OpenStreetMap data through natural language commands and built-in safety protections. It supports discovery of nearby amenities, geographic data exploration, and secure map editing via OAuth authentication.364MIT
- AlicenseNot gradedqualityCmaintenanceFree geospatial MCP server for AI agents, providing geocoding, reverse geocoding, POI search, and route planning using OpenStreetMap data via Nominatim, Overpass, and OSRM.GPL 3.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
- AlicenseAqualityDmaintenanceProvides location-based services and geospatial data from OpenStreetMap, enabling geocoding, route directions, nearby place search, and neighborhood analysis through natural language.12MIT