mcpField
A
AWS-GeoPlaces-MCP-Server

AWS-GeoPlaces-MCP-Server

Local
github.com/dxsimCloud & Infra1Updated 67w ago

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

  1. 01Forward geocoding
  2. 02Reverse geocoding
  3. 03AWS Location Service access
  4. 04GeoPlaces v2 API integration

Use cases

  1. 01Convert an address into location coordinates
  2. 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.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

MseeP.ai Security Assessment Badge

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.

smithery badge

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:

    "weather": {
       "command": "/absolute/path/to/uv",
       "args": [
         "run",
         "--with",
         "mcp[cli]",
         "mcp",
         "run",
         "/absolute/path/to/your/server.py"
       ]
     },
    
  7. Reboot Claude Desktop and use a prompt that will trigger your MCP.

Comments

Markdown supported

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.