高德地址解析服务

什么是高德地址解析服务？

基于 Claude AI 和高德地图 MCP 的智能地址解析服务。提供地址解析、地理编码和位置信息查询功能，支持作为 RESTful API 服务运行，适用于开发者或需要自动地址处理的系统。

如何用高德地址解析服务？

克隆项目后，使用 Python 虚拟环境安装依赖，配置 .env 文件中的高德地图API密钥和 Claude API密钥。可以通过启动 FastAPI 服务（python api/main.py）或直接调用 Python 示例脚本（python examples/basic_usage.py）使用。服务提供 HTTP POST 地址解析接口和健康检查接口。

主要功能

• 智能地址解析：使用 Claude AI 理解自然语言地址查询
• 多种查询方式：地址转坐标、坐标转地址、POI 搜索
• 多轮工具调用：支持复杂连续任务（如旅行规划）
• 多种 LLM 支持：Claude 和 OpenAI 大模型
• RESTful API：完整的 HTTP 接口，异步高性能
• 健康监控、错误处理和重试机制

使用场景

• 将自然语言地址转换为地理坐标（如“北京市朝阳区三里屯太古里”）
• 反向地理编码，根据坐标获取详细地址信息
• 兴趣点（POI）搜索，例如查找“北京大学的地理坐标”
• 批量地址解析，一次处理多个地址
• 多轮工具调用场景，如结合天气查询和路线规划的旅行计划

常见问题

MCP 连接失败怎么办？

检查 AMAP_MAPS_API_KEY 是否正确设置，确认网络连接正常，查看日志文件获取详细错误信息。

Claude API 调用失败如何处理？

检查 ANTHROPIC_API_KEY 是否正确设置，确认 API 密钥有足够配额，检查网络连接。

工具调用超时如何解决？

增加 MCP_SERVER_TIMEOUT 配置值（默认30秒），或检查高德地图 API 服务状态。

依赖包冲突怎么处理？

使用虚拟环境（python -m venv address-parser-env）或 conda 环境隔离依赖。清理 pip 缓存：pip cache purge。

系统支持哪些大模型？

默认支持 Claude（默认模型 claude-3-7-sonnet-20250219）和 OpenAI（默认模型 gpt-4），通过 LLM_PROVIDER 配置选择。