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

Brave Search

modelcontextprotocol

Model Context Protocol Servers

88.1K

小红书自动搜索评论工具（MCP Server 2.0）

chenningling

这是一款基于 Playwright 开发的小红书自动搜索和评论工具，作为 MCP Server，可通过特定配置接入 MCP Client（如Claude for Desktop），帮助用户自动完成登录小红书、搜索关键词、获取笔记内容及发布AI生成评论等操作。

436

Serper Search and Scrape MCP Server

marcopesani

Serper MCP Server supporting search and webpage scraping

158

Web Scout MCP Server

pinkpixel-dev

A powerful MCP server extension providing web search and content extraction capabilities. Integrates DuckDuckGo search functionality and URL content extraction into your MCP environment, enabling AI assistants to search the web and extract webpage content programmatically.

129

SearXNG MCP Server

ihor-sokoliuk

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

1.0K