NearbySearch MCP Server

@kukapay

About NearbySearch MCP Server

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

Config

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

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

Tools

No tools detected

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

FAQ from NearbySearch MCP Server

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").

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

Basic information

More Search MCP servers

Perplexity MCP Zerver

wysh3

MCP web search using perplexity without any API KEYS

Exa MCP Server 🔍

exa-labs

Exa MCP for web search and web crawling!

4.7K

Google News MCP Server

ChanMeng666

【Star-crossed coders unite!⭐️】Model Context Protocol (MCP) server implementation providing Google News search capabilities via SerpAPI, with automatic news categorization and multi-language support.

124

Everything Search MCP Server

mamertofabian

344

Perplexity MCP Server

wysh3

MCP web search using perplexity without any API KEYS