foursquare-places-mcp | 通往MCP之路

MCP 服务器：实现对 Foursquare API 的访问

Foursquare Places API 为需要理解用户位置及其周边环境的应用程序提供了详细的地理位置上下文。该 API 基于一个全球性的开源数据库，涵盖超过 1.5 亿个地点，分布于 1500 多个类别中，能够将原始 GPS 数据转化为有意义的洞察。

GeoTagging API 使用 Foursquare 的 Place Snap 技术，能够精确定位从咖啡店到公园等各类地点，而 Search & Data API 则超越了基本的邻近搜索，允许开发者按类别、特征、营业时间等条件筛选地点。每个结果都包含丰富的元数据，如照片、评论、评分和实时人气指数。

这些工具使得开发者能够构建具备情境感知能力的 AI 代理，根据用户周围环境提供高度个性化的体验。

什么是 MCP？

Model Context Protocol（MCP）是 Anthropic 推出的一项新标准，用于将 AI 系统与数据源连接。了解更多信息，请访问 Anthropic。

MCP 允许您设置服务器，暴露可供 LLM（大型语言模型）直接理解和调用的函数。在本项目中，我们实现了一个 MCP 服务器，能够访问 Foursquare API，以支持本地地点搜索功能。

快速开始

获取 Foursquare Service API Key

为了让您的 AI 代理能够访问 Foursquare API 端点，您需要一个 Foursquare Service API Key。如果尚未拥有，请按照 Foursquare 文档 - 管理您的 Service API Keys 的说明创建一个。

您需要登录您的 Foursquare 开发者账户，或者如果没有账户，可以创建一个（创建基本账户是免费的，并包含项目启动信用额度）。请务必在创建时复制 Service API Key，因为之后将无法再次查看。

下载 Claude 桌面应用

目前 MCP 仅支持本地使用，因此您需要下载 Claude 桌面应用（远程生产环境 MCP 服务器仍在开发中）。

设置 MCP 服务器

Python：按照 fsq-server-python/README.md 中的说明，使用 uv 设置基于 Python 的 MCP 服务器。