About AWS-GeoPlaces-MCP-Server
AWS-GeoPlaces-MCP-Server connects MCP clients to AWS Location Service’s GeoPlaces v2 API for geocoding and reverse geocoding. It is intended for users who need location lookups through an MCP interface.
Key features
- 01Forward geocoding
- 02Reverse geocoding
- 03AWS Location Service access
- 04GeoPlaces v2 API integration
Use cases
- 01Convert an address into location coordinates
- 02Look up an address from location coordinates
MCP support
It exposes AWS Location Service geocoding and reverse-geocoding capabilities to MCP clients.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEAWS-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
- AWS Permissions needed to host MCP for Location Service, Refer to the example json file for the minimum viable permissions.
Development
-
Install
uvfor Python project management:MacOS / Linux:
curl -LsSf https://astral.sh/uv/install.sh | shWindows:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" -
Create a virtual environment
uv venv --python 3.13 -
Start the virtual environment
source .venv/bin/activateNOTE: To stop the virtual environment:
deactivate -
Install MCP Python SDK and AWS boto3 client:
uv add "mcp[cli]" uv add "boto3" uv add "python-dotenv"
Quickstart
-
Run your server in the MCP Inspector:
mcp dev server.py -
Install the server in Claude Desktop:
mcp install <your_server_name.py> -
Open
claude_desktop_config.jsin an editor: From Claude:- Open Claude
- Go to Settings
- In the pop-up, select "Developer"
- 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:which uvWindows:
where uv -
In
claude_desktop_config.js, set thecommandproperty to the fulluvpath for your MCP Server Example:"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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.
