What is Aws Geoplaces Mcp Server

AWS-GeoPlaces-MCP-Server is a server that provides direct access to AWS location services through the GeoPlaces API, enabling geocoding and reverse-geocoding functionalities similar to Google Maps API.

Use cases

Use cases for AWS-GeoPlaces-MCP-Server include developing applications that require address lookup, finding coordinates from addresses, integrating location services into mobile apps, and enhancing user experiences with location data.

How to use

To use AWS-GeoPlaces-MCP-Server, first ensure you have the necessary AWS permissions. Then, set up your development environment by installing the required tools and dependencies, create a virtual environment, and run the server using the MCP Inspector.

Key features

Key features of AWS-GeoPlaces-MCP-Server include direct access to AWS location services, geocoding and reverse-geocoding capabilities, and compatibility with the MCP Python SDK.

Where to use

AWS-GeoPlaces-MCP-Server can be used in various fields such as location-based services, mapping applications, logistics, and any application requiring geographical data processing.

AWS-GeoPlaces-MCP-Server

Directly access AWS location services using the GeoPlaces v2 API, provides geocoding or reverse-geocoding capabilities like the Google Maps API.

Prerequisites

1. AWS Permissions needed to host MCP for Location Service, Refer to the example json file for the minimum viable permissions.

Development

1. Install uv for Python project management:

   MacOS / Linux:

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

   Windows:

   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
   

2. Create a virtual environment

   uv venv --python 3.13
   

3. Start the virtual environment

   source .venv/bin/activate
   

   NOTE: To stop the virtual environment:

   deactivate
   

4. Install MCP Python SDK and AWS boto3 client:

   uv add "mcp[cli]"
   uv add "boto3"
   uv add "python-dotenv"
   

Quickstart

1. Create your MCP using Python

2. Run your server in the MCP Inspector:

   mcp dev server.py
   

3. Install the server in Claude Desktop:

   mcp install <your_server_name.py>
   

4. Open claude_desktop_config.js in an editor:
   From Claude:

   1. Open Claude
   2. Go to Settings
   3. In the pop-up, select “Developer”
   4. Click “Edit Config”

   File location:

   • MacOS / Linux ~/Library/Application/Support/Claude/claude_desktop_config.json
   • Windows AppData\Claude\claude_desktop_config.json

5. Find the full path to uv:
   MacOS / Linux:

   which uv
   

   Windows:

   where uv
   

6. In claude_desktop_config.js, set the command property to the full uv path for your MCP Server
   Example:

7. Reboot Claude Desktop and use a prompt that will trigger your MCP.