Amazon Location Service MCP Server

Amazon Location Service MCP Server

亚马逊位置服务MCP服务器是一个轻量级的MCP服务器，它使AI助手和应用能够通过标准化端点访问实时的AWS地理空间功能，包括地点搜索、地理编码、反向地理编码和路线优化。它允许大语言模型（LLM）以编程方式与亚马逊位置服务互动，为各种代理工作流程带来动态位置智能和自动化。

Author: awslabs


查看协议

亚马逊位置服务MCP服务器是什么？

亚马逊位置服务MCP服务器是模型上下文协议（MCP）的一个实现，它将基于LLM的工具和助手连接到亚马逊位置服务API。通过这个服务器，AI代理可以搜索地点、执行地址地理编码和反向地理编码、计算路线，并使用MCP标准化端点利用其他AWS地理空间功能。它提供了一个可扩展的桥梁，将LLM环境与AWS强大的位置平台连接起来，便于在对话和自动化工具基础场景中的集成。

如何配置亚马逊位置服务MCP服务器

  1. 前提条件

    • 确保你已从Astral安装uv。
    • 安装Python（例如，uv python install 3.10）。
    • 使用有亚马逊位置服务权限的访问密钥或AWS配置文件配置你的AWS凭证。

  2. MCP服务器配置示例

    • 将亚马逊位置服务MCP服务器条目添加到你的MCP客户端配置文件中（例如，~/.aws/amazonq/mcp.json，.cursor/mcp.json等）：

      {
  "mcpServers": {
    "awslabs.aws-location-mcp-server": {
      "command": "uvx",
      "args": [
        "awslabs.aws-location-mcp-server@latest"
      ],
      "env": {
        "AWS_PROFILE": "your-aws-profile",
        "AWS_REGION": "us-east-1",
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

  3. 环境变量

    • 根据需要设置AWS_PROFILE和AWS_REGION。
    • 对于容器化部署，适当地通过--env或--env-file传递凭证。

  4. 激活

    • 确保MCP服务器已启用（在你的配置中未标记为"disabled": true）。

  5. 可选

    • 可以根据组织的安全最佳实践自定义日志级别或使用基于角色的认证。

如何使用亚马逊位置服务MCP服务器

  1. 发现可用工具

    • 使用MCP客户端接口或API通过tools/list端点列出工具。这将揭示基于位置的功能，如地点搜索和地理编码。

  2. 调用位置工具

    • 通过tools/call端点使用相关参数调用工具。例如，提供查询和可选过滤器执行地点搜索；提供源点和目标坐标获取路线方向。

  3. 工作流中的典型步骤

    • 在集成LLM的IDE或聊天应用中，提示助手利用亚马逊位置服务MCP工具进行以下任务：
      • “搜索我办公室附近的咖啡店。”
      • “将这个地址转换为经纬度。”
      • “从这里到机场的最佳路线是什么？”

  4. 客户端中的工具批准

    • 如果被提示，请批准工具调用（许多客户端提供自动批准的选项，简化工作流程）。

  5. 查看结果

    • AI助手或自动化管道将接收结构化响应（例如，地点列表、坐标结果、路线详情），以便进一步处理、展示、生成代码或执行业务逻辑。

  6. 示例命令行用法

    • 手动运行MCP服务器进行测试： 
      timeout 15s uv tool run awslabs.aws-location-mcp-server --region us-east-1 2>&1 || echo "完成或超时"

主要功能

  • 无缝地点搜索：查询支持的AWS数据提供商的商名、地标和地址。
  • 地理编码与反向地理编码：在地址和经纬度坐标之间进行转换。
  • 路线优化：计算最佳路线、估计旅行时间和距离。
  • MCP工具发现：直接显示LLM代理可用的标准化文档功能。
  • 安全的AWS集成：利用IAM角色和策略控制对位置查询和服务的访问。
  • 低延迟本地或云部署：在本地运行MCP服务器以保护隐私，或远程运行以实现始终可用和可扩展的使用。
  • 可扩展和可配置：根据应用或组织需求，调整端点和服务。

使用案例

  • 对话助手：使LLM驱动的聊天机器人回答用户位置问题，执行实时地点查找，或推荐商家和兴趣点。
  • 现场服务自动化：通过地理空间API自动生成指引，优化现场路线并派遣，结果在AI驱动的仪表板或工作流程中显示。
  • 客户体验代理：帮助用户查找商店位置、验证地址或检查营业时间。
  • 应用开发：将地理编码、路线规划和临近搜索集成到网络/移动应用的后端逻辑中。
  • 数据标注：将非结构化地址地理定位，或用精确坐标标注数据集，用于分析和可视化。

常见问题

问1：使用亚马逊位置服务MCP服务器需要哪些AWS权限？
答1：使用的AWS凭证或配置文件必须被授权访问亚马逊位置服务的操作，如geo:SearchPlaceIndexForText、geo:CalculateRoute以及你打算暴露的其他位置API操作。

问2：我可以按地理位置或数据提供商限制响应吗？
答2：可以，MCP服务器支持指定区域、边界框、数据提供商或根据亚马逊位置服务API配置的自定义过滤器的参数。

问3：这个服务器是否存储或记录任何位置数据？
答3：默认情况下，服务器不会持久化或记录敏感的位置信息查询或响应。可以调整日志记录级别以便调试，但建议查看设置以确保隐私合规。

问4：我能在离线状态下运行亚马逊位置服务MCP服务器吗？
答4：虽然服务器可以在本地运行，但需连接AWS以提供实时位置数据。可能实现有限缓存，但大多数功能需要网络访问。

问5：我如何在我的LLM助手中使用这些位置工具？
答5：配置完成后，只需提示你的AI助手使用所需的位置工具，或让LLM在处理地理空间查询时自动选择相关工具。批准和结果通过你的客户端界面进行管理。