feat: Adding AWS Location MCP server

.secrets.baseline

@@ -124,15 +124,35 @@
     },
     {
       "path": "detect_secrets.filters.heuristic.is_templated_secret"
-    },
-    {
-      "path": "detect_secrets.filters.regex.should_exclude_file",
-      "pattern": [
-        ".secrets.baseline"
-      ]
     }
   ],
   "results": {
+    "src/aws-location-mcp-server/tests/test_server.py": [
+      {
+        "type": "AWS Access Key",
+        "filename": "src/aws-location-mcp-server/tests/test_server.py",
+        "hashed_secret": "d70eab08607a4d05faa2d0d6647206599e9abc65",
+        "is_verified": false,
+        "line_number": 757,
+        "is_secret": false
+      },
+      {
+        "type": "Base64 High Entropy String",
+        "filename": "src/aws-location-mcp-server/tests/test_server.py",
+        "hashed_secret": "d70eab08607a4d05faa2d0d6647206599e9abc65",
+        "is_verified": false,
+        "line_number": 757,
+        "is_secret": false
+      },
+      {
+        "type": "Secret Keyword",
+        "filename": "src/aws-location-mcp-server/tests/test_server.py",
+        "hashed_secret": "d70eab08607a4d05faa2d0d6647206599e9abc65",
+        "is_verified": false,
+        "line_number": 767,
+        "is_secret": false
+      }
+    ],
     "src/bedrock-kb-retrieval-mcp-server/README.md": [
       {
         "type": "Base64 High Entropy String",
@@ -170,5 +190,5 @@
       }
     ]
   },
-  "generated_at": "2025-05-05T14:50:32Z"
+  "generated_at": "2025-05-07T18:33:23Z"
 }

README.md

@@ -21,6 +21,7 @@ A suite of specialized MCP servers that help you get the most out of AWS, wherev
   - [AWS Diagram MCP Server](#aws-diagram-mcp-server)
   - [AWS Lambda MCP Server](#aws-lambda-mcp-server)
   - [AWS Terraform MCP Server](#aws-terraform-mcp-server)
+  - [AWS Location Service MCP Server](#aws-location-service-mcp-server)
   - [Git Repo Research MCP Server](#git-repo-research-mcp-server)
   - [Use Cases for the Servers](#use-cases-for-the-servers)
 - [Installation and Setup](#installation-and-setup)
@@ -183,6 +184,22 @@ A server for AWS Terraform best practices.
 
 [Learn more](src/terraform-mcp-server/README.md) | [Documentation](https://awslabs.github.io/mcp/servers/terraform-mcp-server/)
 
+### AWS Location Service MCP Server
+
+[![PyPI version](https://img.shields.io/pypi/v/awslabs.aws-location-mcp-server.svg)](https://pypi.org/project/awslabs.aws-location-mcp-server/)
+
+A server for accessing AWS Location Service capabilities, focusing on place search, geographical coordinates, and route planning.
+
+- Search for places using geocoding
+- Get details for specific places by PlaceId
+- Reverse geocode coordinates to addresses
+- Search for places near a location
+- Search for places that are currently open
+- Calculate routes between locations with turn-by-turn directions
+- Optimize waypoints for efficient routing
+
+[Learn more](src/aws-location-mcp-server/README.md)
+
 ### Git Repo Research MCP Server
 
 [![PyPI version](https://img.shields.io/pypi/v/awslabs.git-repo-research-mcp-server.svg)](https://pypi.org/project/awslabs.git-repo-research-mcp-server/)
@@ -285,6 +302,17 @@ Example configuration for Amazon Q CLI MCP (`~/.aws/amazonq/mcp.json`):
        },
        "disabled": false,
        "autoApprove": []
+     },
+    "awslabs.aws-location-mcp-server": {
+       "command": "uvx",
+       "args": ["awslabs.aws-location-mcp-server@latest"],
+       "env": {
+         "AWS_PROFILE": "your-aws-profile",
+         "AWS_REGION": "us-east-1",
+         "FASTMCP_LOG_LEVEL": "ERROR"
+       },
+       "disabled": false,
+       "autoApprove": []
     },
     "awslabs.git-repo-research-mcp-server": {
       "command": "uvx",

src/aws-location-mcp-server/.gitignore

@@ -0,0 +1,88 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+venv/
+env/
+ENV/
+.venv/
+.env/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Testing
+.coverage
+htmlcov/
+.pytest_cache/
+.tox/
+.nox/
+coverage.xml
+*.cover
+.hypothesis/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Local development
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Cache
+.ruff_cache/
+__pycache__/
+.mypy_cache/
+.pytest_cache/

src/aws-location-mcp-server/.pre-commit-config.yaml

@@ -0,0 +1,27 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.9.7
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+        exclude: ^mkdocs\.yml$
+      - id: check-added-large-files
+      - id: check-case-conflict
+      - id: check-merge-conflict
+      - id: debug-statements
+      - id: check-toml
+
+
+  - repo: https://github.com/commitizen-tools/commitizen
+    rev: v3.20.0
+    hooks:
+      - id: commitizen
+        stages: [commit-msg]

src/aws-location-mcp-server/.python-version

@@ -0,0 +1 @@
+3.10

src/aws-location-mcp-server/CHANGELOG.md

@@ -0,0 +1,38 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2025-04-17
+
+### Added
+- Initial release of the AWS Location Service MCP Server
+- Added `search_places` tool for geocoding and place search
+- Added `get_coordinates` tool for retrieving location coordinates
+- Support for AWS credentials via environment variables or AWS CLI profiles
+- Support for custom place index configuration
+
+### Changed
+- Implemented using FastMCP framework for MCP protocol handling
+- Structured project to match other MCP servers
+
+## [1.1.0] - 2025-05-06
+
+### Added
+- `GeoPlacesClient`: Client for AWS Location Service geo-places API.
+- `GeoRoutesClient`: Client for AWS Location Service route calculation API.
+- `search_places` tool: Search for places using text queries.
+- `get_place` tool: Retrieve details for a specific place by PlaceId.
+- `reverse_geocode` tool: Convert coordinates to a human-readable address.
+- `search_nearby` tool: Find places near a given location, with radius expansion.
+- `search_places_open_now` tool: Find places currently open, with support for opening hours and radius expansion.
+- `get_coordinates` tool: Get coordinates for a location name or address.
+- `calculate_route` tool: Calculate routes between two locations, supporting travel modes (`Car`, `Truck`, `Walking`, `Bicycle`) and route optimization (`FastestRoute`, `ShortestRoute`).
+- `optimize_waypoints` tool: Optimize the order of waypoints for a route using AWS Location Service.
+
+### Changed
+- Refactored `calculate_route` to expose only `departure_position`, `destination_position`, `travel_mode`, and `optimize_for` as parameters. Internal options are now local variables.
+- Updated tests and documentation to match the new tool signatures and AWS documentation.
+- Improved error handling and output consistency for route calculation and waypoint optimization tools.

src/aws-location-mcp-server/Dockerfile

@@ -0,0 +1,76 @@
+# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance
+# with the License. A copy of the License is located at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
+# OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
+# and limitations under the License.
+
+FROM public.ecr.aws/sam/build-python3.10@sha256:04cdbe84bec08d17d621192bc3f0a9e4a85a83f2ac99aa9241659dfac0d845ea AS uv
+
+# Install the project into `/app`
+WORKDIR /app
+
+# Enable bytecode compilation
+ENV UV_COMPILE_BYTECODE=1
+
+# Copy from the cache instead of linking since it's a mounted volume
+ENV UV_LINK_MODE=copy
+
+# Prefer the system python
+ENV UV_PYTHON_PREFERENCE=only-system
+
+# Run without updating the uv.lock file like running with `--frozen`
+ENV UV_FROZEN=true
+
+# Install the project's dependencies using the lockfile and settings
+COPY pyproject.toml uv.lock ./
+RUN --mount=type=cache,target=/root/.cache/uv \
+    pip install uv && \
+    uv sync --frozen --no-install-project --no-dev --no-editable
+
+# Then, add the rest of the project source code and install it
+# Installing separately from its dependencies allows optimal layer caching
+COPY . /app
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --frozen --no-dev --no-editable
+
+# Make the directory just in case it doesn't exist
+RUN mkdir -p /root/.local
+
+FROM public.ecr.aws/sam/build-python3.10@sha256:04cdbe84bec08d17d621192bc3f0a9e4a85a83f2ac99aa9241659dfac0d845ea
+
+# Place executables in the environment at the front of the path and include other binaries
+ENV PATH="/app/.venv/bin:$PATH:/usr/sbin"
+
+# Install lsof for the healthcheck
+# Install AWS CLI for AWS credentials management
+# Add non-root user and ability to change directory into /root
+RUN yum update -y && \
+    yum install -y lsof && \
+    yum clean all -y && \
+    rm -rf /var/cache/yum && \
+    groupadd --force --system app && \
+    useradd app -g app -d /app && \
+    chmod o+x /root
+
+# Get the project from the uv layer
+COPY --from=uv --chown=app:app /root/.local /root/.local
+COPY --from=uv --chown=app:app /app/.venv /app/.venv
+
+# Get healthcheck script
+COPY ./docker-healthcheck.sh /usr/local/bin/docker-healthcheck.sh
+RUN chmod +x /usr/local/bin/docker-healthcheck.sh
+
+# Run as non-root
+USER app
+
+# AWS_REGION should be provided at runtime
+# Example: docker run -e AWS_REGION=us-east-1 image_name
+
+# Health check and entrypoint
+HEALTHCHECK --interval=30s --timeout=30s --start-period=5s --retries=3 CMD [ "docker-healthcheck.sh" ]
+ENTRYPOINT ["awslabs.aws-location-mcp-server"]