MCP.so
Sign In

NearbySearch MCP Server

@kukapay

Repository

About NearbySearch MCP Server

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

Basic information

Category

Search

License

MIT

Runtime

python

Transports

stdio

Publisher

kukapay

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

Comments

More Search MCP servers

MCP SearXNG Enhanced Server

OvertliDS

Enhanced MCP server for SearXNG: category-aware web-search, web-scraping, and date/time retrieval.

54

Exa MCP Server 🔍

exa-labs

Exa MCP for web search and web crawling!

4.7K

Google Search Tool

web-agent-master

A Playwright-based Node.js tool that bypasses search engine anti-scraping mechanisms to execute Google searches. Local alternative to SERP APIs with MCP server integration.

611

Kagi MCP server

kagisearch

The Official Model Context Protocol (MCP) server for Kagi Search & other tools.

435

Bing Search MCP Server

leehanchung

MCP Server for Bing Search API

78