🚀 MCP-Geo
MCP-Geo 是一个使用 GeoPY! 进行地编解码的 MCP 服务器，为大型语言模型 (LLMs) 提供强大的地编解码工具。
🚀 快速开始
克隆仓库
git clone [your-repository-url]
cd mcp-geo
安装依赖
pip install -r requirements.txt
启动服务器
python geo.py
📋 系统要求
- Python 3.6+
📦 依赖项
安装所有必需的依赖项：
# 使用 uv
uv 同步
必须的包
- fastmcp：构建 Model Context Protocol 服务器的框架
- geoPy：用于访问和对地理位置进行地编解码/反向地编解码的 Python 库。
所有依赖项均在 requirements.txt 中列出，以便轻松安装。
🛠️ MCP 工具
此 MCP 服务器为大型语言模型 (LLMs) 提供以下地编解码工具：
geocode_location
- 接受用户提供的地址或地点名称，并返回最佳匹配的纬度、经度和格式化地址。
- 灵活处理错误，无需指定经纬度参数。
reverse_geocode
- 根据经纬度坐标返回地理位置信息。
geocode_batch
- 批量地编解码功能，支持多个地址或经纬度的处理。
📁 项目结构
mcp-geo/
├── geo.py # 主业务逻辑文件
├── config.py # 配置管理模块
└── requirements.txt # 依赖项管理文件
🔧 技术细节
环境变量
| 变量名 | 描述 | 默认值 |
|---|---|---|
GEOCODER_PROVIDER |
"nominatim", "arcgis", 或 "bing" | nominatim |
NOMINATIM_URL |
Nominatim 域名 | nominatim.openstreetmap.org |
SCHEME |
http/https | http |
ARC_USERNAME |
ArcGIS 用户名 | None |
ARC_PASSWORD |
ArcGIS 密码 | None |
BING_API_KEY |
您的 Bing Maps 密钥。 | None |
这些可以在您的 shell 中设置，或在 MCP 设置文件中针对您的环境进行配置。
如果需要更多自定义，请编辑 geo.py 并根据您使用的地编解码器添加所需的变量。