20_《智能体微服务架构企业级实战教程》高德地图FastMCP服务之工具类封装

前言

配套视频教程： 👉《智能体微服务架构企业级实战教程》共72节

更多文章专栏内容： 👉《智能体微服务架构企业级实战教程》专栏

本文介绍了高德地图FastMCP服务中工具类的封装与测试。首先在.env和config.py中添加高德API地址与密钥配置。在utils.py中实现两个核心工具：geocode异步函数通过高德地理编码API将地址转换为经纬度坐标；async_retry装饰器为异步函数提供自动重试能力（支持重试次数、初始延迟、退避系数），并集成日志记录失败与重试信息。测试代码test_utils.py演示了geocode对正常地址和无效地址的调用效果，以及async_retry装饰器在模拟临时失败后重试成功的行为。通过运行测试验证工具类的正确性与健壮性。该封装为后续路径规划和美食搜索等高级工具奠定了可靠的基础能力。

一、添加配置参数

在 .env 文件添加高德地图配置项

# 高德地图（供gaode_mcp_server使用）AMAP_API_URL