NearbySearch MCP Server

@kukapay

Basic information

About NearbySearch MCP Server

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

NearbySearch MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "nearby-search-mcp": {
      "command": "python",
      "args": [
        "main.py"
      ]
    }
  }
}

NearbySearch MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is NearbySearch MCP Server?

NearbySearch MCP Server is an MCP server that enables nearby place searches by combining IP-based location detection (via ipapi.co) with Google Places API. It serves users who need quick, location-aware search capabilities within MCP environments like Claude Desktop.

How to use NearbySearch MCP Server?

Clone the repository, install dependencies (mcp, httpx, python-dotenv) using uv or pip, and configure your client with a GOOGLE_API_KEY environment variable. Run the server in development mode with mcp dev main.py, install it in Claude Desktop with mcp install main.py --name "NearbySearch", or execute directly with python main.py. The sole tool endpoint, search_nearby, accepts a keyword string, an optional radius in meters (default 1500), and an optional place type such as "restaurant" or "cafe".

Key features of NearbySearch MCP Server

IP-based location detection using ipapi.co
Google Places integration for nearby searches
Single tool endpoint with customizable radius
Optional type filter for place categories
Configurable search radius (default 1500 meters)

Use cases of NearbySearch MCP Server

Finding coffee shops near your current location
Searching for restaurants within a specified radius
Locating nearby cafes, parks, or other place types
Integrating location-aware search into MCP-enabled applications

Frequently asked questions

What are the requirements to run NearbySearch MCP Server?

Python 3.10 or higher, a Google Cloud Platform API key with Places API enabled, and an internet connection.

How do I install NearbySearch MCP Server?

Clone the repository, install dependencies (using uv or pip: mcp, httpx, python-dotenv), then configure your client with the GOOGLE_API_KEY environment variable.

How do I run NearbySearch MCP Server?

You can run it in development mode with `mcp dev main.py`, install it in Claude Desktop with `mcp install main.py --name "NearbySearch"`, or execute directly with `python main.py`.

What parameters does the search_nearby tool accept?

Keyword (required string), radius (optional integer in meters, default 1500), and type (optional string, e.g., "restaurant" or "cafe").

Comments

More Search MCP servers

InstaVision

Find Instagram creators and leads by niche, city, follower range or lookalike accounts.

patent-literature-search-mcp

patsnap

A professional tool for searching Patsnap’s global patent and literature databases using natural language, semantic, or keyword queries. It supports precise filtering and retrieves bibliographic data in Markdown format.

Singapore Proxy

Singapore Mobile Proxy

Give Claude, Cursor or any MCP agent a real Singapore mobile IP. Fetch pages, run Singapore-localised Google searches and check geo-locked content through physical Singtel and M1 SIMs, with IP rotation on demand. Hosted

Knowra

Rex Zhang

Search papers on arXiv by research topic and exact announcement date, then read full-text paper briefs. An arXiv paper search and literature search tool for AI agents: search_papers returns titles, authors and abstracts

Theyond

theyond

If it's here, it's on their board. Search live verified jobs from employer career pages.