内容
# 薄空气地理MCP服务器
**为您的AI代理提供完整的地理空间感知能力** — 地址和交叉路口地理编码、多种模式（汽车、卡车、自行车、行人）路线规划、实时交通和天气、绘制可达性多边形、搜索地点。置信度评分的结果让您的代理知道何时需要再次询问。10个工具通过MCP。
**10个MCP工具** · 地理编码、路线规划、交通、天气、地点搜索 · 为车队级工作流而构建
[](https://www.npmjs.com/package/@thinairtelematics/geo)
[](LICENSE)
[](https://smithery.ai/servers/thinair/geo)
```console
> 地理编码 "休斯顿湾港码头"
✓ 匹配：湾港集装箱码头
✓ 置信度：0.97
✓ 坐标：29.6008, -95.0201
```
## 薄空气的一部分
薄空气地理是薄空气车队工作流背后的地理空间智能层：地理编码、路线规划上下文、地址搜索、服务区可见性、地图智能、交通、天气和可达性。
## 主机产品与此仓库
- `geo.thinair.co` 是托管的薄空气产品。
- 此仓库是为开发者和AI代理客户端提供的薄公共MCP包/指针。
- 生产使用可能需要薄空气账户、API密钥、OAuth连接或托管工作空间。
## 它做什么
薄空气地理是一个[模型上下文协议（MCP）](https://modelcontextprotocol.io)服务器，为AI代理提供全栈地理空间工具 — 无需API集成。可实际路由的坐标：交叉路口级精度，置信度评分，无静默回退（不确定时返回空结果，而不是城市中心猜测）。
- **地理编码** — 前向、反向、交叉路口和批处理（每次调用50个）。结果包括`置信度`和`方法`，以便代理可以根据质量进行分支。
- **路线规划** — 多配置文件：汽车、卡车、自行车、行人、摩托车。10个卡车特定预设（干货厢、平板车、阶梯式货车、油罐车、箱式货车、汽车运输车、快递车、双拖车、超大尺寸）具有危险品/尺寸/重量/时间距离约束。
- **交通** — 30多个美国大都市的实时状况。
- **天气** — 当前状况和预报。
- **地点搜索和探索** — 附近的POI、地域发现，人口过滤。
- **等时线** — 驾驶时间/步行时间可达性多边形（每次调用多个波段）。
## 产品链接
- **产品：** https://geo.thinair.co
- **连接/获取密钥：** https://geo.thinair.co/connect
- **文档：** https://geo.thinair.co/docs/getting-started
- **定价：** https://geo.thinair.co/checkout
- **薄空气：** https://thinair.co
## 工具
| 工具 | 描述 |
|------|-------------|
| `geocode` | 将地址、地点名称或交叉路口转换为坐标 |
| `reverse_geocode` | 将坐标转换为地址 |
| `batch_geocode` | 批量地理编码最多50个地址（返回`geojson`要素集合） |
| `directions` | 逐向路线规划 — 汽车、卡车、自行车、行人、摩托车 |
| `isochrone` | 旅行时间/距离可达性多边形（多频段） |
| `traffic` | 实时交通状况 |
| `weather` | 当前状况和预报 |
| `search_places` | 按类别查找附近的POI（加油站、充电站、食品、住宿等） |
| `explore` | 按区域浏览城市、社区和场所 |
| `quota` | 检查当前计划、每日用量和剩余容量（免费，从不扣除） |
此外，还有一个`issue_api_key`实用程序 — 通过MCP暴露用于API密钥发放流程，但不属于客户面向的10工具界面。大多数客户端在首次使用时完成OAuth，从不直接调用它。
## 卡车车辆配置文件
在`directions`或`isochrone`上传递以下任意一个作为`vehicle_profile`以自动设置尺寸：
| 配置文件 | 尺寸/用途 |
|---------|------------------------|
| `DRY_VAN_53` | 53′干货厢 — 标准美国货运（默认） |
| `FLATBED_48` | 48′平板车，装载高度14′ |
| `FLATBED_40` | 40′平板车，区域/专业 |
| `STEP_DECK` | 阶梯式货车 / 降落式货车，11′3″上层货架间隙 |
| `TANKER` | 液体/气体油罐车（配`hazmat=true`） |
| `BOX_TRUCK_26` | 26′箱式货车，当地配送 |
| `AUTO_CARRIER` | 汽车运输车 / 汽车运输 |
| `SPRINTER_VAN` | 货车，最后一英里（9′高） |
| `DOUBLE_TRAILER` | 双28′拖车，LTL长途（92′总长） |
| `OVERSIZE` | 允许的超大负载 — 按运输业务覆盖尺寸 |
单个参数（`truck_height`、`truck_weight`、`truck_length`、`axle_count`等）覆盖预设。
## 快速入门
### 克劳德桌面，游标，风帆 — OAuth（推荐，无密钥）
将以下内容添加到客户端的MCP配置中（例如`~/Library/Application Support/Claude/claude_desktop_config.json`）：
```json
{
"mcpServers": {
"thinair-geo": {
"url": "https://geo.thinair.co/mcp"
}
}
}
```
OAuth流程在首次使用时完成 — 无需手动令牌设置。免费层：每天15个请求，无需信用卡。
### API密钥（适用于非OAuth客户端）
```json
{
"mcpServers": {
"thinair-geo": {
"url": "https://geo.thinair.co/mcp",
"headers": {
"Authorization": "Bearer ta_live_..."
}
}
}
}
```
在https://geo.thinair.co/connect获取密钥。
### npx（CLI/脚本）
```bash
npx -y @thinairtelematics/geo
```
将配置块打印到stdout以供客户端使用。与上述相同，默认情况下使用OAuth无密钥选项。
## 不是用于秘密
不要提交API密钥。在支持的地方使用OAuth或通过MCP客户端的安全环境/头部配置传递API密钥。
## npm软件包
[npmjs.com/package/@thinairtelematics/geo](https://www.npmjs.com/package/@thinairtelematics/geo)
> 以前发布为`thinair-geo`（现在弃用，改为作用域包）。
## 许可证
MIT © [薄空气远程信息技术](https://thinair.co)
