Advertise
MCP.so
Sign In

NearbySearch MCP Server

@kukapay

Repository

Basic information

Category

Search

License

MIT

Transports

stdio

Author

kukapay

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

1

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.

2

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.

3

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`.

4

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

Aguasto Research

Aguasto

Official read-only MCP access to Aguasto's public GPU, model and infrastructure research. Search published descriptions and retrieve canonical source links. Anonymous Streamable HTTP; GPU rental and token-based inference

S

SlickTrip

Slicktrip LLC

Live flight, hotel and seat prices for AI assistants. Search fares and hotel rates, find the cheapest days on a calendar, check open seats on a flight, and set price-drop, seat and bucket-list alerts.

Sorank

Thibault Besson-Magdelain

Sorank connects Google Search Console, PageSpeed Insights, and AI citability scoring to your assistant, so it can diagnose why a page underperforms and tell you exactly what to change. Sorank gives your AI assistant dir

QuanticData — Web Scraping MCP Server

QuanticData

Web scraping MCP server for AI agents: scrape any page to clean Markdown, SERP search (Google, Bing, DuckDuckGo), site crawl and map, 74 ready-made collectors and residential proxies. 25 tools, pay per success.

CueHQ

Russell Shen

CueHQ's MCP server gives your agent the Reddit, X, YouTube and TikTok threads where people ask for what you sell, ranked and deduplicated, with reply drafts in your voice that keep learning from your edits. It's for deve

Advertise