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で無料で取得できます — 1日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.
| Name | Required | Description | Default |
|---|---|---|---|
| lat | Yes | ||
| lng | Yes | ||
| radius | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description fully covers behavior: radius interpretation, caching with 10-minute TTL, live recalculation of hours, and null handling for unknown hours. It discloses all behavioral traits beyond the basic function.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is well-structured with purpose, usage, parameters, and return fields. Every sentence adds value; no redundant or extraneous text. Front-loaded the key purpose in the first sentence.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given no output schema, the description completely documents all return fields with explanations, including edge cases like null values. All parameters are explained. The tool's behavior (caching, live hours) is fully covered.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0%, but the description provides detailed parameter semantics: lat/lng ranges, radius meaning with default and maximum, and concrete usage guidance. This goes far beyond the schema's minimal type information.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The first sentence clearly states the tool identifies a place from GPS coordinates and returns label, category, and live opening-hours status. The verb 'identify' combined with the resource 'place' and specific outputs makes the purpose unmistakable.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly says 'Use this whenever the user provides coordinates or asks what is at a location.' This direct instruction tells the agent exactly when to invoke the tool, leaving no ambiguity.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
1 tool update
v0.1.1- First observed
get_location_label
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.
Maintenance
Related MCP Connectors
Worldwide place search with coordinates (Open-Meteo) — paid per call (x402/credits), 1 tools
Nominatim MCP — wraps OpenStreetMap Nominatim geocoding API (free, no auth)
OpenTripMap MCP — wraps the OpenTripMap Places API (dev.opentripmap.org)
- geoOAuthco.thinair
Geocoding, routing, isochrones, traffic, weather, and place search for AI agents. 19 MCP tools.
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.314MIT
- 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.1GPL 3.0
- AlicenseAqualityCmaintenanceMCP 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
- AlicenseAqualityBmaintenanceProvides location-based services and geospatial data from OpenStreetMap, enabling geocoding, route directions, nearby place search, and neighborhood analysis through natural language.12MIT