kukapay/nearby-search-mcp
Free用于附近地点搜索的 MCP 服务器，带基于 IP 的位置检测。
FreeFree tier
Inputs: text
About kukapay/nearby-search-mcp
NearbySearch MCP Server is an open-source Model Context Protocol (MCP) server that enables location-aware place searches. It automatically detects the user's IP-based location using ipapi.co and integrates with Google Places API to find nearby places based on keywords, radius, and optional type filters. The server provides a single 'search_nearby' tool endpoint with customizable radius, making it easy to integrate into AI assistants like Claude for on-the-fly local search. Requires Python 3.10+ and a Google Cloud API key with Places API enabled.
Key Features
IP-based location detection via ipapi.co
Google Places API integration for nearby place searches
Single search_nearby tool endpoint with keyword, radius, and type parameters
Customizable search radius (default 1500 meters)
Supports place type filters such as 'restaurant' or 'cafe'
Pros & Cons
Pros
- Free and open-source under MIT license
- Simple setup with clear configuration instructions
- Automatic location detection eliminates manual coordinates
- Well-documented single tool endpoint for easy integration
- Actively maintained with community support on GitHub
Cons
- Requires a Google Cloud API key with Places API enabled (may incur costs)
- Location accuracy depends on IP geolocation, which can be imprecise
- Only supports Google Places data source
- No built-in caching or offline search support
Best For
Find nearby coffee shops, restaurants, or cafes based on current locationIntegrate location-aware place search into AI assistants like Claude DesktopDevelop location-based automation and context-aware applicationsExplore points of interest within a defined radius
FAQ
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 set up the server with Claude Desktop?
Use the command 'mcp install main.py --name "NearbySearch"' after installing dependencies, or configure manually with the provided JSON in your MCP client settings.
Is the location detection accurate?
Location detection uses ipapi.co to determine approximate location based on IP address. Precision may vary and is not as accurate as GPS.
What parameters can I pass to the search_nearby tool?
You can specify a keyword (required), radius in meters (optional, default 1500), and a place type filter (optional, e.g., 'restaurant', 'cafe').