NearbySearch MCP Server

NearbySearch MCP Server

An MCP server for nearby place searches with IP-based location detection.

kukapay

Location Services
Visit Server

README

NearbySearch MCP Server

An MCP server for nearby place searches with IP-based location detection.

GitHub License GitHub Last Commit Python Version

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:
git clone https://github.com/kukapay/nearby-search-mcp.git
cd nearby-search-mcp
  1. Install dependencies:
# Using uv (recommended)
uv add "mcp[cli]" httpx python-dotenv

# Or using pip
pip install mcp httpx python-dotenv
  1. Client Configuration
{
  "mcpServers": {
    "nearby-search": {
      "command": "uv",
      "args": ["--directory", "path/to/nearby-search-mcp", "run", "main.py"],
      "env": {
        "GOOGLE_API_KEY": "your google api key"
      }
    }
  }
}

Usage

Running the Server

  • Development Mode (with MCP Inspector):
mcp dev main.py
  • Install in Claude Desktop:
mcp install main.py --name "NearbySearch"
  • Direct Execution:
python main.py

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 file for details.

Recommended Servers

Nefino MCP Server

Nefino MCP Server

Provides large language models with access to news and information about renewable energy projects in Germany, allowing filtering by location, topic (solar, wind, hydrogen), and date range.

Official
Python
flightradar24-mcp-server

flightradar24-mcp-server

A Claude Desktop MCP server that helps you track flights in real-time using Flightradar24 data. Perfect for aviation enthusiasts, travel planners, or anyone curious about flights overhead!

Local
JavaScript
Smart Photo Journal MCP Server

Smart Photo Journal MCP Server

This MCP server aids users in searching and analyzing their photo library by location, labels, and people, offering functionalities like photo analysis and fuzzy matching for enhanced photo management.

Local
Python
Vilnius Transport MCP Server

Vilnius Transport MCP Server

Enables Large Language Models to access real-time data on Vilnius public transport stops and routes through the Model Context Protocol.

Python
Surf MCP Server

Surf MCP Server

Fetches tide information for any location using latitude and longitude, providing detailed tide data including high/low tides and station information with automatic UTC time zone handling.

Python
TripAdvisor Vacation Planner MCP Server

TripAdvisor Vacation Planner MCP Server

This MCP server provides access to TripAdvisor data for planning vacations, enabling users to search for and get details about locations, attractions, restaurants, and hotels through an interactive planning experience.

Python
IP Geolocation MCP Server

IP Geolocation MCP Server

A Model Context Protocol server that retrieves detailed geographic information about IP addresses using the ipinfo.io API, helping determine user location and network details.

Python
Buienradar MCP Server

Buienradar MCP Server

Fetches precipitation forecasts for any location using Buienradar and integrates with Claude for Desktop to provide accurate two-hour weather predictions.

Python
noaa-tidesandcurrents-mcp

noaa-tidesandcurrents-mcp

This is an MCP (Model Context Protocol) server that provides tools for interacting with the NOAA Tides and Currents API.

TypeScript
HeFeng Weather MCP Server

HeFeng Weather MCP Server

Provides weather forecast data for locations in China using the HeFeng Weather API, with real-time, hourly, or daily forecasts and location-based queries.

TypeScript