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:

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

Windows:

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

1. Create a virtual environment

bash uv venv --python 3.13

1. Start the virtual environment

bash source .venv/bin/activate

NOTE: To stop the virtual environment:

bash deactivate

1. Install MCP Python SDK and AWS boto3 client:

bash 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: bash mcp dev server.py
3. Install the server in Claude Desktop: bash mcp install <your_server_name.py>

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

5. Open Claude

6. Go to Settings
7. In the pop-up, select "Developer"
8. Click "Edit Config"

File location:

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

• Windows AppData\Claude\claude_desktop_config.json

• Find the full path to uv: MacOS / Linux: bash which uv Windows: bash where uv

• In claude_desktop_config.js, set the command property to the full uv path for your MCP Server Example: json "weather": { "command": "/absolute/path/to/uv", "args": [ "run", "--with", "mcp[cli]", "mcp", "run", "/absolute/path/to/your/server.py" ] },
• Reboot Claude Desktop and use a prompt that will trigger your MCP.