nearby places.com
nearby places.com logo

Nearby Places

Integrates with Google Places API to provide location-based place discovery using IP-based detection, enabling users to...

Created byApr 23, 2025

NearbySearch MCP Server

An MCP server for nearby place searches with IP-based location detection.
![GitHub License](https://img.shields.io/github/license/kukapay/nearby-search-mcp) ![GitHub Last Commit](https://img.shields.io/github/last-commit/kukapay/nearby-search-mcp) ![Python Version](https://img.shields.io/badge/python-3.10%2B-blue)

Features

  • **IP-based Location Detection**: Uses ipapi.co to determine your current location
  • **Google Places Integration**: Searches for nearby places based on keywords and optional type filters
  • **Simple Interface**: Single tool endpoint with customizable radius

Requirements

  • Python 3.10+
  • Google Cloud Platform API Key with Places API enabled
  • Internet connection

Installation

  1. Clone the repository:
  1. Install dependencies:
  1. Client Configuration

Usage

Running the Server

  • **Development Mode** (with MCP Inspector):
  • **Install in Claude Desktop**:
  • **Direct Execution**:

Available Endpoints

**Tool: `search_nearby`**
  • Searches for places near your current location
  • Parameters: - `keyword` (str): What to search for (e.g., "coffee shop") - `radius` (int, optional): Search radius in meters (default: 1500) - `type` (str, optional): Place type (e.g., "restaurant", "cafe")

License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.