kukapay/nearby-search-mcp

kukapay/nearby-search-mcp

от kukapay
Сервер для поиска мест рядом - определяет ваше местоположение по IP и ищет объекты через Google Places. Удобен для быстрого поиска кафе, ресторанов и других заведений по ключевым словам и радиусу.

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"
      }
    }
  }
}

Часто задаваемые вопросы

У этого сервера пока нет списка инструментов.

Выберите клиент, чтобы установить kukapay/nearby-search-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

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

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

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

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

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

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"kukapay-nearby-search-mcp-1xz888zxsj\",\"type\":\"stdio\",\"env\":{\"GOOGLE_API_KEY\":\"your google api key\"},\"args\":[\"--directory\",\"path/to/nearby-search-mcp\",\"run\",\"main.py\"],\"command\":\"uv\"}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

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

Добавьте сервер одной командой в терминале:

claude mcp add kukapay-nearby-search-mcp-1xz888zxsj --env GOOGLE_API_KEY=your google api key -- uv --directory path/to/nearby-search-mcp run main.py

Либо через JSON-конфиг:

claude mcp add-json kukapay-nearby-search-mcp-1xz888zxsj "{\"env\":{\"GOOGLE_API_KEY\":\"your google api key\"},\"args\":[\"--directory\",\"path/to/nearby-search-mcp\",\"run\",\"main.py\"],\"command\":\"uv\"}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add kukapay-nearby-search-mcp-1xz888zxsj --env GOOGLE_API_KEY=your google api key -- uv --directory path/to/nearby-search-mcp run main.py

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.kukapay-nearby-search-mcp-1xz888zxsj]
command = "uv"
args = ["--directory", "path/to/nearby-search-mcp", "run", "main.py"]

[mcp_servers.kukapay-nearby-search-mcp-1xz888zxsj.env]
GOOGLE_API_KEY = "your google api key"
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите kukapay/nearby-search-mcp, а в поле команды запуска — строку ниже:
uv --directory path/to/nearby-search-mcp run main.py

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

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

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "kukapay-nearby-search-mcp-1xz888zxsj": {
      "env": {
        "GOOGLE_API_KEY": "your google api key"
      },
      "args": [
        "--directory",
        "path/to/nearby-search-mcp",
        "run",
        "main.py"
      ],
      "command": "uv",
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например kukapay-nearby-search-mcp-1xz888zxsj.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: kukapay-nearby-search-mcp-1xz888zxsj
    command: uv
    args:
      - "--directory"
      - "path/to/nearby-search-mcp"
      - "run"
      - "main.py"
    env:
      GOOGLE_API_KEY: your google api key
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

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

Похожие MCP-сервера

ipfind/ipfind-mcp-server

ipfind/ipfind-mcp-server

от ipfind

Определяет страну, город и координаты по IP-адресу через сервис IP Find. Работает по API-ключу, подходит для геоаналитики и проверки трафика.

JavaScript⭐ 3
iplocate/mcp-server-iplocate

iplocate/mcp-server-iplocate

от iplocate

Сервер для геолокации IP-адресов через IPLocate.io: определяет местоположение, сеть, провайдера, проверяет на VPN/прокси/Tor и выдаёт контакты для жалоб. MCP инструмент полезен аналитикам безопасности и разработчикам для обогащения данных об IP без лишних сложностей.

JavaScript⭐ 20
geolabel/geolabel-mcp

geolabel/geolabel-mcp

от geolabel

GeoLabel MCP сервер превращает GPS-координаты в контекст местоположения для AI-ассистентов: название, категория и часы работы в реальном времени. Полезен разработчикам и пользователям Claude, помог...

Python⭐ 1
cablate/mcp-google-map

cablate/mcp-google-map

от cablate

Ищет места на Google Maps, строит маршруты до 25 точек, показывает погоду, качество воздуха и снимки карт. 18 инструментов, больше, чем у Google Grounding.

TypeScript⭐ 473
APOGEOAPI/apogeoapi-mcp

APOGEOAPI/apogeoapi-mcp

от apogeoapi

MCP сервер для доступа к ApogeoAPI: геоданные, курсы валют и IP-геолокация. Он позволяет ИИ-ассистентам получать актуальные данные о странах, городах и валютах прямо из диалога. Бесплатный тариф: 1000 запросов в месяц.

TypeScript⭐ 1
ip2location/mcp-ip2location-io

ip2location/mcp-ip2location-io

от ip2location

MCP-сервер для геолокации по IP-адресу. Возвращает страну, город, координаты, провайдера, информацию о прокси и безопасности. Полезен разработчикам и администраторам для анализа сетевого трафика и ...

Python⭐ 16
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин