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-omnisearch

spences10

🔍 A Model Context Protocol (MCP) server providing unified access to multiple search engines (Tavily, Brave, Kagi, Exa), AI tools (Kagi FastGPT, Exa, Linkup), and content extraction services (Firecrawl, Tavily, Kagi). Includes GitHub search. All through a single interface.

332

Naver Search MCP Server

isnow890

MCP server for Naver Search API integration. Provides comprehensive search capabilities across Naver services (web, news, blog, shopping, etc) and data trend analysis tools via DataLab API.

77

SearXNG MCP Server

ihor-sokoliuk

Private web search for AI assistants via SearXNG — supports Claude, Cursor, and any MCP client

1.0K

MCP SearXNG Enhanced Server

OvertliDS

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

54

Perplexity MCP Zerver

wysh3

MCP web search using perplexity without any API KEYS

93