地点搜索服务

mcp foursquare

用于Foursquare地点搜索和发现的MCP服务器。让你的AI助手找到场地， 搜索某个位置附近的位置，查找位置详细信息，并获取位置上下文——全部 通过Foursquare Places API v3。

状态： 准备就绪

先决条件

• 包子 运行时间(curl -fsSL https://bun.sh/install | bash)
• A. Foursquare开发者 帐户和API密钥

安装

git clone git@github.com:McCullonas/mcp-foursquare.git
cd mcp-foursquare
bun install

配置

服务器需要一个环境变量：

获取API密钥： location.foursquare.com/developer. 免费套餐包括每天1000次通话。

可用工具

search_near

搜索指定位置（城市、社区、地标）附近的地方。

参数：

• query --搜索什么（例如。 "coffee", "museum")
• near --指定位置（例如。 "Edinburgh, UK", "Soho, London")
• categories （可选） --要筛选的Foursquare类别ID
• limit （可选） --最大结果（默认值10）

search_near_point

搜索特定纬度/经度坐标附近的地点。

参数：

• query --搜索什么
• ll --坐标为 "lat,lng" （例如。 "51.5074,-0.1278")
• radius （可选） --搜索半径（单位：米）
• limit （可选） --最大结果

place_snap

在给定位置获取最有可能的位置——这对地理标记很有用。

参数：

• ll --坐标为 "lat,lng"
• accuracy （可选） --GPS精度（单位：米）

place_details

通过Foursquare ID获取特定地点的详细信息。

返回：描述、电话、网站、时间、评级、价格水平、菜单链接、照片、提示。

参数：

• fsq_id --Foursquare地点ID（来自搜索结果）

get_location

根据用户的IP地址（通过IP-api.com）获取大致位置。有用作为 当没有提供明确位置时的起点。

无需参数。

MCP客户端配置

添加到您的 settings.json （或 claude_desktop_config.json):

{
  "mcpServers": {
    "foursquare": {
      "command": "bun",
      "args": ["run", "/path/to/mcp-foursquare/src/index.ts"],
      "env": {
        "FOURSQUARE_SERVICE_TOKEN": "your-token-here"
      }
    }
  }
}

替换 /path/to/mcp-foursquare 带有克隆的绝对路径。

发展

# Run directly
bun run src/index.ts

# Build (outputs to dist/)
bun build src/index.ts --outdir dist --target node

许可证

麻省理工学院