nearby-search-mcp

by kukapay
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Integrates with Google Places API to search for nearby places based on keywords, with options for radius customization and type filtering.

  • Uses Google Cloud Platform API Key with Places API to perform location-based searches for nearby points of interest.

近隣検索MCPサーバー

IP ベースの位置検出を使用して近くの場所を検索するための MCP サーバー。

特徴

  • IPベースの位置検出:ipapi.coを使用して現在地を特定します
  • Googleプレイス統合: キーワードとオプションのタイプフィルターに基づいて近くの場所を検索します
  • シンプルなインターフェース: 半径をカスタマイズできる単一のツールエンドポイント

要件

  • Python 3.10以上
  • Places API が有効になっている Google Cloud Platform API キー
  • インターネット接続

インストール

  1. リポジトリをクローンします。
git clone https://github.com/kukapay/nearby-search-mcp.git cd nearby-search-mcp
  1. 依存関係をインストールします:
# Using uv (recommended) uv add "mcp[cli]" httpx python-dotenv # Or using pip pip install mcp httpx python-dotenv
  1. クライアント構成
{ "mcpServers": { "nearby-search": { "command": "uv", "args": ["--directory", "path/to/nearby-search-mcp", "run", "main.py"], "env": { "GOOGLE_API_KEY": "your google api key" } } } }

使用法

サーバーの実行

  • 開発モード(MCP Inspector を使用):
mcp dev main.py
  • Claude Desktopにインストール:
mcp install main.py --name "NearbySearch"
  • 直接実行
python main.py

利用可能なエンドポイント

ツール: search_nearby

  • 現在地近くの場所を検索します
  • パラメータ:
    • keyword (str): 検索対象 (例: 「コーヒーショップ」)
    • radius (int, オプション): 検索半径(メートル単位)(デフォルト: 1500)
    • type (str, オプション): 場所の種類 (例: "restaurant"、"cafe")

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

-
security - not tested
A
license - permissive license
-
quality - not tested

IP ベースの位置検出を使用して近くの場所を検索するための MCP サーバー。

  1. Features
    1. Requirements
      1. Installation
        1. Usage
          1. Running the Server
          2. Available Endpoints
        2. License
          ID: uz39j7nvm8