mcpField
N
NearbySearch MCP Server

NearbySearch MCP Server

本地服务
github.com/kukapay搜索与检索2283 周前更新
代码仓库

关于 NearbySearch MCP Server

NearbySearch MCP Server 是一个 MCP 服务，通过 IP 定位获取当前位置，并基于 Google Places 搜索附近地点。适合需要按关键词查找周边场所的用户，其特点是接口简单，仅提供一个搜索工具。

主要功能

  1. 01基于 IP 的位置检测（ipapi.co）
  2. 02Google Places 附近搜索
  3. 03支持按关键词与类型筛选
  4. 04可自定义搜索半径，默认 1500 米

适用场景

  1. 01在 Claude Desktop 中查找附近的咖啡店
  2. 02按类型（如 restaurant、cafe）筛选周边餐饮场所

MCP 相关

该项目是一个 MCP 服务，向 MCP 客户端暴露名为 search_nearby 的工具，用于按关键词和可选参数搜索附近地点。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

NearbySearch MCP Server

一个用于附近地点搜索的 MCP 服务，支持基于 IP 的位置检测。

GitHub License GitHub Last Commit Python Version

功能

  • 基于 IP 的位置检测：使用 ipapi.co 确定你当前的位置
  • Google Places 集成：根据关键词和可选的类型筛选条件搜索附近地点
  • 简单的接口：提供单个工具端点，并可自定义搜索半径

要求

  • 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，可选）：地点类型（例如，“餐厅”、“咖啡馆”）

许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。