AWS-GeoPlaces-MCP-Server

AWS-GeoPlaces-MCP-Server

site icon
2025.05.07 0
Python地理编码反向地理编码AWS 服务集成位置服务
AWS-GeoPlaces-MCP-Server 是一个直接访问 AWS 位置服务的工具,提供类似于 Google Maps API 的地理编码和反向地理编码功能。它允许开发者通过 GeoPlaces v2 API 集成 AWS 的位置服务到他们的应用中。
View on GitHub

Overview

基本能力

产品定位

AWS-GeoPlaces-MCP-Server 是一个中间件服务,旨在简化 AWS 位置服务的集成过程,提供地理编码和反向地理编码功能。

核心功能

  • 地理编码:将地址转换为地理坐标。
  • 反向地理编码:将地理坐标转换为地址。
  • 直接访问 AWS 的 GeoPlaces v2 API。

适用场景

  • 需要集成 AWS 位置服务的应用开发。
  • 需要地理编码或反向地理编码功能的应用。
  • 开发者希望简化 AWS 服务集成的过程。

工具列表

  • uv:Python 项目管理工具。
  • MCP Python SDK:用于创建和管理 MCP 服务的 SDK。
  • boto3:AWS 的 Python SDK。
  • python-dotenv:用于管理环境变量的 Python 库。

常见问题解答

  • 需要 AWS 权限来托管 MCP 服务,具体权限可以参考示例 JSON 文件。

使用教程

使用依赖

  1. 安装 uv 工具:
  2. MacOS / Linux: bash curl -LsSf https://astral.sh/uv/install.sh | sh
  3. Windows: bash powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

  4. 创建虚拟环境: bash uv venv --python 3.13

  5. 启动虚拟环境: bash source .venv/bin/activate

  6. 安装依赖: bash uv add "mcp[cli]" uv add "boto3" uv add "python-dotenv"

安装教程

  1. 创建 MCP 服务: bash mcp dev server.py

  2. 安装服务到 Claude Desktop: bash mcp install <your_server_name.py>

  3. 配置 Claude Desktop:

  4. 打开 Claude Desktop 的配置文件 claude_desktop_config.js
  5. 设置 command 属性为 uv 的完整路径。
  6. 示例配置: json "weather": { "command": "/absolute/path/to/uv", "args": [ "run", "--with", "mcp[cli]", "mcp", "run", "/absolute/path/to/your/server.py" ] },

调试方式

  1. 重启 Claude Desktop。
  2. 使用会触发 MCP 服务的提示进行测试。

许可证

该项目遵循 Apache-2.0 开源许可条款,请参阅 Apache-2.0 了解完整条款。