MCP-Geo 是一款地理编码 MCP 服务器，旨在为大型语言模型 (LLM) 提供强大的位置服务。它利用 GeoPY 库，使 LLM 能够理解和交互地理位置数据，实现地址到经纬度的转换（地理编码）以及经纬度到地址的反向转换（逆地理编码）。通过 MCP-Geo，LLM 可以轻松获取位置的详细信息，计算地址间的距离，并批量处理地理位置数据。

该服务器通过 fastmcp 框架构建，无缝集成到 MCP 生态系统中，为开发者提供了一系列易于使用的 MCP 工具。它还具备速率限制和错误处理等安全特性，确保服务的稳定性和可靠性。开发者可以通过简单的命令安装 MCP-Geo，并根据需要配置不同的地理编码服务提供商，例如 Nominatim、ArcGIS 或 Bing。MCP-Geo 极大地扩展了 LLM 的应用场景，使其能够更好地服务于需要地理位置信息的应用。

地理编码：地址转经纬度

MCP-Geo的核心功能之一是将地址或地点名称转换为经纬度和格式化的地址。它利用GeoPY库，通过调用geocode_location函数实现。该功能允许AI模型理解和处理基于位置的信息，例如，用户输入“北京市朝阳区建国门外大街”，模型可以返回对应的经纬度坐标以及规范化的地址信息。这使得模型能够将抽象的地理位置概念与具体的坐标数据关联起来，为后续的地理位置分析、地图应用等提供基础数据。在技术实现上，MCP-Geo通过fastmcp框架将此功能暴露为MCP工具，方便LLM调用。如果GeoPY在处理请求时遇到问题，例如地址无法识别，MCP-Geo会捕获geopy异常并返回None结果，保证系统的稳定性。

逆地理编码：经纬度转地址

MCP-Geo的另一个核心功能是逆地理编码，即将经纬度坐标转换为最接近的地址。通过调用reverse_geocode函数，MCP-Geo可以根据给定的经纬度信息，查找对应的地理位置描述。例如，用户提供经纬度“39.9042, 116.4074”，模型可以返回“北京市天安门广场”等地址信息。这项功能对于需要根据用户位置提供服务的应用场景至关重要，例如，基于位置的推荐、附近的商家搜索等。在技术实现上，MCP-Geo同样依赖GeoPY库，并将其封装为易于LLM调用的MCP工具。为了防止滥用，MCP-Geo实现了速率限制，避免过多的请求对系统造成压力。

详细地理编码：获取更多位置信息

除了基本的地理编码功能，MCP-Geo还提供geocode_with_details函数，返回更详细的地理位置信息，例如边界框（bounding box）和详细的地址组成部分。例如，对于一个给定的地址，模型不仅可以返回经纬度，还可以返回该地址所在的行政区域、邮政编码等信息，甚至可以返回该区域的边界坐标，方便在地图上进行可视化。这对于需要进行精细化地理位置分析的应用场景非常有用，例如，城市规划、物流优化等。技术上，此功能同样基于GeoPY，并集成了错误处理机制，确保在无法获取详细信息时，能够返回合理的结果，避免程序崩溃。

集成优势：灵活配置与扩展

MCP-Geo的集成优势在于其灵活的配置选项和可扩展性。通过环境变量，用户可以轻松切换不同的地理编码服务提供商，例如Nominatim、ArcGIS或Bing Maps。这意味着用户可以根据自己的需求和预算选择最合适的地理编码服务，而无需修改代码。此外，MCP-Geo还支持自定义Nominatim URL，允许用户使用私有的Nominatim服务器，提高数据安全性和隐私性。这种灵活性使得MCP-Geo能够适应不同的应用场景和技术环境，为开发者提供更大的自由度。