Nearby Places

by kukapay

17 stars

381 downloads

Not rated

GitHub

About

Integrates with Google Places API to provide location-based place discovery using IP-based detection, enabling users to find nearby businesses, restaurants, or services without manually entering coordinates.

Details

Author: kukapay
Repository: kukapay/nearby-search-mcp
GitHub stars: 17
Downloads: 381
License: MIT License
Categories: Design, Developer Tools, Search, API, Infrastructure, Frontend
Tags: #integration

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Nearby Places

Command (node, npx, python, etc.) uv
Arguments
- Argument 1 --directory
- Argument 2 path/to/nearby-search-mcp
- Argument 3 run
- Argument 4 main.py
Environment
- GOOGLE_API_KEY your google api key
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "nearby places": {
            "env": {
                "GOOGLE_API_KEY": "your google api key"
            },
            "args": [
                "--directory",
                "path/to/nearby-search-mcp",
                "run",
                "main.py"
            ],
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "nearby places": {
            "env": {
                "GOOGLE_API_KEY": "your google api key"
            },
            "args": [
                "--directory",
                "path/to/nearby-search-mcp",
                "run",
                "main.py"
            ],
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "nearby places": {
            "env": {
                "GOOGLE_API_KEY": "your google api key"
            },
            "args": [
                "--directory",
                "path/to/nearby-search-mcp",
                "run",
                "main.py"
            ],
            "command": "uv"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "nearby places": {
            "env": {
                "GOOGLE_API_KEY": "your google api key"
            },
            "args": [
                "--directory",
                "path/to/nearby-search-mcp",
                "run",
                "main.py"
            ],
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "nearby places": {
            "env": {
                "GOOGLE_API_KEY": "your google api key"
            },
            "args": [
                "--directory",
                "path/to/nearby-search-mcp",
                "run",
                "main.py"
            ],
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "nearby places": {
            "env": {
                "GOOGLE_API_KEY": "your google api key"
            },
            "args": [
                "--directory",
                "path/to/nearby-search-mcp",
                "run",
                "main.py"
            ],
            "command": "uv"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "nearby places": {
            "env": {
                "GOOGLE_API_KEY": "your google api key"
            },
            "args": [
                "--directory",
                "path/to/nearby-search-mcp",
                "run",
                "main.py"
            ],
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "nearby places": {
            "env": {
                "GOOGLE_API_KEY": "your google api key"
            },
            "args": [
                "--directory",
                "path/to/nearby-search-mcp",
                "run",
                "main.py"
            ],
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "nearby places": {
            "env": {
                "GOOGLE_API_KEY": "your google api key"
            },
            "args": [
                "--directory",
                "path/to/nearby-search-mcp",
                "run",
                "main.py"
            ],
            "command": "uv"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "nearby places": {
            "env": {
                "GOOGLE_API_KEY": "your google api key"
            },
            "args": [
                "--directory",
                "path/to/nearby-search-mcp",
                "run",
                "main.py"
            ],
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "nearby places": {
            "env": {
                "GOOGLE_API_KEY": "your google api key"
            },
            "args": [
                "--directory",
                "path/to/nearby-search-mcp",
                "run",
                "main.py"
            ],
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "nearby places": {
            "env": {
                "GOOGLE_API_KEY": "your google api key"
            },
            "args": [
                "--directory",
                "path/to/nearby-search-mcp",
                "run",
                "main.py"
            ],
            "command": "uv"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "nearby places": {
            "env": {
                "GOOGLE_API_KEY": "your google api key"
            },
            "args": [
                "--directory",
                "path/to/nearby-search-mcp",
                "run",
                "main.py"
            ],
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "nearby places": {
            "env": {
                "GOOGLE_API_KEY": "your google api key"
            },
            "args": [
                "--directory",
                "path/to/nearby-search-mcp",
                "run",
                "main.py"
            ],
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "nearby places": {
            "env": {
                "GOOGLE_API_KEY": "your google api key"
            },
            "args": [
                "--directory",
                "path/to/nearby-search-mcp",
                "run",
                "main.py"
            ],
            "command": "uv"
        }
    }
}

From the repository

- Development Mode (with MCP Inspector):

mcp dev main.py

- Install in Claude Desktop:

mcp install main.py --name "NearbySearch"

- Direct Execution:

python main.py

`search_nearby`

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

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "nearby places": {
            "env": {
                "GOOGLE_API_KEY": "your google api key"
            },
            "args": [
                "--directory",
                "path/to/nearby-search-mcp",
                "run",
                "main.py"
            ],
            "command": "uv"
        }
    }
}

Linux

{
    "env": {
        "GOOGLE_API_KEY": "your google api key"
    },
    "args": [
        "--directory",
        "path/to/nearby-search-mcp",
        "run",
        "main.py"
    ],
    "command": "uv"
}

Macos

{
    "env": {
        "GOOGLE_API_KEY": "your google api key"
    },
    "args": [
        "--directory",
        "path/to/nearby-search-mcp",
        "run",
        "main.py"
    ],
    "command": "uv"
}

Windows

{
    "env": {
        "GOOGLE_API_KEY": "your google api key"
    },
    "args": [
        "--directory",
        "path/to/nearby-search-mcp",
        "run",
        "main.py"
    ],
    "command": "uv"
}

NearbySearch MCP Server

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

Features

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

2. Install dependencies:

# Using uv (recommended)

uv add "mcp[cli]" httpx python-dotenv
Or using pip
pip install mcp httpx python-dotenv

3. 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.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

search_nearby

Claude Desktop / Cursor

Linux

Macos

Windows

NearbySearch MCP Server

Features

Requirements

Installation

Or using pip

Usage

Running the Server

Available Endpoints

License

Install

More like this

Sentry

Github

Brave Search

Git

GitLab

Context 7

`search_nearby`