NearbySearch MCP Server

Name: NearbySearch MCP Server
Author: kukapay

@kukapay

代码仓库

关于 NearbySearch MCP Server

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

基本信息

分类

搜索

许可证

MIT

运行时

python

传输方式

stdio

发布者

kukapay

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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

搜索分类下的更多 MCP 服务器

Perplexity MCP Server

wysh3

MCP web search using perplexity without any API KEYS

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