内容
# GeoLabel MCP 服务器
<!-- mcp-name: io.github.TylerCoxDruin/geolabel -->
将 GPS 坐标转换为 AI 就绪的位置上下文 — 适用于 Claude Desktop、Claude Code 和任何 MCP 兼容的助手。
## 功能描述
发送坐标。获取地点名称、类别和实时营业时间：
```json
{
"label": "沃尔玛",
"category": "超市",
"is_open": true,
"closes_at": "23:00",
"opening_hours": "周一至周日 06:00-23:00"
}
```
Claude 可以回答： *"你正在沃尔玛，沃尔玛将在 47 分钟后关门。"*
---
## 快速设置
### 1. 获取 GeoLabel API 密钥
在 [geolabel.dev](https://geolabel.dev) 上免费获取 — 每天 100 次请求，不需要信用卡。
### 2. 添加到您的代理
选择下面的客户端。
---
#### Claude Desktop
编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`:
```json
{
"mcpServers": {
"geolabel": {
"command": "uvx",
"args": ["geolabel-mcp"],
"env": {
"GEOLABEL_API_KEY": "glk_您的密钥_在此"
}
}
}
}
```
重启 Claude Desktop。GeoLabel 工具将出现在工具列表中。
#### Claude Code
```bash
claude mcp add geolabel -- uvx geolabel-mcp
export GEOLABEL_API_KEY=glk_您的密钥_在此
```
#### Hermes Agent
编辑 `~/.hermes/config.json`:
```json
{
"mcpServers": {
"geolabel": {
"command": "uvx",
"args": ["geolabel-mcp"],
"env": {
"GEOLABEL_API_KEY": "glk_您的密钥_在此"
}
}
}
}
```
查看 [Hermes Agent MCP 文档](https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp) 以获取更多信息。
#### OpenClaw
```bash
# 注册服务器
openclaw mcp set geolabel \
--command uvx \
--args geolabel-mcp \
--env GEOLABEL_API_KEY=glk_您的密钥_在此
# 验证已注册
openclaw mcp list
```
查看 [OpenClaw MCP 文档](https://docs.openclaw.ai/cli/mcp) 以获取更多信息。
---
### 3. 使用它
```
您：我在 41.8827, -87.6233 — 这里是什么地方？它现在开业吗？
代理：您正在健身房（Planet Fitness）。它目前开业，今晚 11:00 关门 — 您还有大约 3 小时。
```
---
## 工具
### `get_location_label`
在给定坐标的 `radius` 米范围内识别最近的命名地点。
| 参数 | 类型 | 默认值 | 描述 |
| --- | --- | --- | --- |
| `lat` | float | 必需 | 纬度（-90 至 90） |
| `lng` | float | 必需 | 经度（-180 至 180） |
| `radius` | int | 100 | 搜索半径（米，最大 500） |
**响应字段：**
| 字段 | 类型 | 描述 |
| --- | --- | --- |
| `place` | string \| null | OpenStreetMap 的原始场地名称 |
| `label` | string | 清洁、适合显示的名称 |
| `category` | string \| null | 稳定类型：`gym`、`supermarket`、`restaurant` 等 |
| `distance_meters` | float \| null | 从您的坐标到该地点的距离 |
| `is_open` | bool \| null | `true` 开业 · `false` 关闭 · `null` 无营业时间数据 |
| `opens_at` | string \| null | 下一个开业时间 `HH:MM`（关闭时） |
| `closes_at` | string \| null | 今日关门时间 `HH:MM`（开业时） |
| `opening_hours` | string \| null | OpenStreetMap 的原始 `opening_hours` 字符串 |
| `cached` | bool | 从 10 分钟缓存中提供；营业时间始终实时重新计算 |
---
## 替代安装
```bash
# pip
pip install geolabel-mcp
# 直接运行
GEOLABEL_API_KEY=glk_xxx geolabel-mcp
```
### Claude Code
```bash
claude mcp add geolabel -- uvx geolabel-mcp
```
然后设置您的密钥：
```bash
# 添加到您的 shell 配置文件或 .env
export GEOLABEL_API_KEY=glk_您的密钥_在此
```
---
## 配置
| 变量 | 必需 | 描述 |
| --- | --- | --- |
| `GEOLABEL_API_KEY` | 是 | 您的 GeoLabel API 密钥 |
| `GEOLABEL_BASE_URL` | 否 | 覆盖 API 基本 URL（默认：`https://api.geolabel.dev`） |
---
## 隐私
GeoLabel 在服务器日志触摸磁盘之前会剥离坐标。不会存储任何移动历史记录。数据实时处理并立即丢弃。 [完整隐私政策 →](https://geolabel.dev/terms.html)
---
## 许可证
MIT
