NearbySearch MCP Server

NearbySearch MCP Server

IP-based nearby search via Google Places, packaged as an MCP tool.

21
Stars
7
Forks
21
Watchers
5
Issues
NearbySearch MCP Server enables users to search for nearby places using their IP-based location, leveraging the Google Places API. Designed to run as an MCP server, it offers an accessible interface for location-aware searches with customizable radius and filter options. The tool supports integration with clients such as Claude Desktop and features a simple setup process using Python 3.10+. Ideal for use cases where model context needs to be enriched with location-based search results.

Key Features

IP-based geographic location detection using ipapi.co
Google Places API integration for place searches
Single endpoint (tool) with parameterized search
Command-line and direct execution support
MCP Inspector development mode
Easy installation and setup instructions
Environment variable support for Google API Key
Customizable search radius and place type filtering
Compatibility with Claude Desktop and MCP clients
MIT licensed open-source solution

Use Cases

Enhancing agent tools with local business recommendations
Providing AI-driven chatbots with real-time location awareness
Programmatically retrieving nearby places within an application
Context enrichment for digital assistants using place data
Integrating location-based search into workflow automation
Supplying model prompts with dynamic geolocation context
Enabling travel or lifestyle applications to suggest venues
Supporting voice assistants in finding nearby services
Developer experimentation with place search services
Building personalized recommendation systems based on user location

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

# Or using pip
pip install mcp httpx python-dotenv
  1. Client Configuration
json
{
  "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):
bash
mcp dev main.py
  • Install in Claude Desktop:
bash
mcp install main.py --name "NearbySearch"
  • Direct Execution:
bash
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.

Star History

Star History Chart

Repository Owner

kukapay
kukapay

User

Repository Details

Language Python
Default Branch main
Size 12 KB
Contributors 1
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

Python
100%

Tags

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • G-Search MCP

    G-Search MCP

    Parallel Google search server with MCP support for structured AI context.

    G-Search MCP is a server for executing parallel Google searches optimized for use with AI tools through the Model Context Protocol. It efficiently handles multiple queries at once, simulates realistic user behavior to evade detection, and returns well-structured JSON responses. The server is configurable, supports parameter tuning like search limits and timeouts, and is designed for seamless integration in AI-driven environments such as Claude Desktop.

    • 224
    • MCP
    • jae-jae/g-search-mcp
  • Google Ads MCP Server

    Google Ads MCP Server

    Seamlessly connect Google Ads API to MCP clients with automatic authentication and querying.

    Google Ads MCP Server is a FastMCP-powered Model Context Protocol server designed to integrate Google Ads API with MCP clients such as Claude Desktop. It provides automatic OAuth 2.0 authentication, smart token management, GAQL query execution, and keyword research tools. The server enables users to manage accounts, run advanced queries, and generate keyword ideas while maintaining secure local token storage. Optimized for one-click setup, it offers robust features for advertisers and developers looking to leverage Google Ads data with MCP-compatible tools.

    • 76
    • MCP
    • gomarble-ai/google-ads-mcp-server
  • tavily-search MCP server

    tavily-search MCP server

    A search server that integrates Tavily API with Model Context Protocol tools.

    tavily-search MCP server provides an MCP-compliant server to perform search queries using the Tavily API. It returns search results in text format, including AI responses, URLs, and result titles. The server is designed for easy integration with clients like Claude Desktop or Cursor and supports both local and Docker-based deployment. It facilitates AI workflows by offering search functionality as part of a standardized protocol interface.

    • 44
    • MCP
    • Tomatio13/mcp-server-tavily
  • MCP-Geo

    MCP-Geo

    Geocoding and reverse geocoding MCP server for LLMs.

    MCP-Geo provides geocoding and reverse geocoding capabilities to AI models using the Model Context Protocol, powered by the GeoPY library. It offers various tools such as address lookup, reverse lookup from coordinates, distance calculations, and batch processing of locations, all accessible via standard MCP tool interfaces. Safety features like rate limiting and robust error handling ensure reliable and compliant usage of geocoding services. The server is compatible with environments like Claude Desktop and can be easily configured elsewhere.

    • 28
    • MCP
    • webcoderz/MCP-Geo
  • @dealx/mcp-server

    @dealx/mcp-server

    MCP server enabling LLMs to search and interact with the DealX platform.

    Implements the Model Context Protocol, providing a standardized interface for large language models to interact with the DealX platform. Supports searching for ads through structured prompts and is designed for easy integration with tools like Claude and VS Code extensions. Flexible configuration options are available for environment variables, logging, and deployment. Extensible architecture supports future feature additions beyond ad search.

    • 0
    • MCP
    • DealExpress/mcp-server
  • kagi-server MCP Server

    kagi-server MCP Server

    TypeScript-based MCP server for Kagi Search API integration.

    Kagi-server MCP Server provides a TypeScript implementation of a Model Context Protocol (MCP) server that integrates with the Kagi Search API. It enables standardized tool access for performing web searches and plans for features like summarization, FastGPT integration, and enriched news results. Compatible with Claude Desktop and Smithery installations, it supports secure environment configuration and offers developer utilities such as automatic build and debugging via MCP Inspector.

    • 40
    • MCP
    • ac3xx/mcp-servers-kagi
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results