Archestra Logo
Archestra.AI
Back to Catalog

nearby-search-mcp

kukapay/nearby-search-mcp
🔗 Latest commit:9509a13
🕒 Updated:Sep 9, 2025, 01:06 PM
Python
Location

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

MCP Trust Score
Based on our comprehensive evaluation criteria
🤖 Evaluated by gemini-2.5-flashFix
Trust Score42/100
GitHub Metrics
Repository statistics and activity
⭐ GitHub Stars:12
👥 Contributors:1
📋 Total Issues:4
📦 Has Releases:No
🔧 Has CI/CD Pipeline:No
Configuration
Configuration example extracted from README.md for Claude Desktop and other clients.
🤖 Evaluated by gemini-2.5-flashFix
{
  "nearby-search": {
    "command": "uv",
    "args": [
      "--directory",
      "path/to/nearby-search-mcp",
      "run",
      "main.py"
    ],
    "env": {
      "GOOGLE_API_KEY": "your google api key"
    }
  },
  "nearby-search-dev": {
    "command": "mcp",
    "args": [
      "dev",
      "main.py"
    ],
    "env": {}
  },
  "nearby-search-direct": {
    "command": "python",
    "args": [
      "main.py"
    ],
    "env": {}
  }
}
MCP Protocol Support
Implemented MCP protocol features
🤖 Evaluated by gemini-2.5-flashFix
Tools:✓
Prompts:✗
Resources:✗
Sampling:✗
Roots:✗
Logging:✗
STDIO Transport:✓
HTTP Transport:✗
OAuth2 Auth:✗
Dependencies
3 dependencies
Libraries and frameworks used by this MCP server
🤖 Evaluated by gemini-2.5-flashFix
Resources
GitHub Repository
Add Quality Badge
Show your MCP trust score in your README
Trust Score Badge
[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/kukapay/nearby-search-mcp)](https://archestra.ai/mcp-catalog/kukapay__nearby-search-mcp)
Edit This ServerAdd New MCP ServerReport an Issue
README.md

NearbySearch MCP Server

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

GitHub License
GitHub Last Commit
Python Version

Features

  • IP-based Location Detection: Uses ipapi.co to determine your current location
  • Google Places Integration: Searches for nearby places based on keywords and optional type filters
  • Simple Interface: Single tool endpoint with customizable radius

Requirements

  • Python 3.10+
  • Google Cloud Platform API Key with Places API enabled
  • Internet connection

Installation

  1. Clone the repository:
git clone https://github.com/kukapay/nearby-search-mcp.git
cd nearby-search-mcp
  1. Install dependencies:
# Using uv (recommended)
uv add "mcp[cli]" httpx python-dotenv

# Or using pip
pip install mcp httpx python-dotenv
  1. Client Configuration
{
  "mcpServers": {
    "nearby-search": {
      "command": "uv",
      "args": ["--directory", "path/to/nearby-search-mcp", "run", "main.py"],
      "env": {
        "GOOGLE_API_KEY": "your google api key"
      }
    }
  }
}

Usage

Running the Server

  • Development Mode (with MCP Inspector):
mcp dev main.py
  • Install in Claude Desktop:
mcp install main.py --name "NearbySearch"
  • Direct Execution:
python main.py

Available Endpoints

Tool: search_nearby

  • Searches for places near your current location
  • Parameters:
    • keyword (str): What to search for (e.g., "coffee shop")
    • radius (int, optional): Search radius in meters (default: 1500)
    • type (str, optional): Place type (e.g., "restaurant", "cafe")

License

This project is licensed under the MIT License - see the LICENSE file for details.

Related MCP Servers

open-streetmap-mcp

65/100

An OpenStreetMap MCP server implementation that enhances LLM capabilities with location-based services and geospatial data.

qgis_mcp

59/100

Model Context Protocol (MCP) that allows LLMs to use QGIS Desktop

google-maps

57/100

Reference MCP servers that are no longer maintained

mcp-weather

53/100

A Model Context Protocol (MCP) server that provides hourly and daily weather forecasts using the AccuWeather API.

mcp-server-ipinfo

52/100

IP Geolocation Server for MCP

MCP-Geo

51/100

Geocoding MCP server with GeoPY!