Yelp MCP

🚀 Yelp Fusion AI的MCP服务器

Yelp Fusion AI 为您的应用程序带来了对话式智能，使用户能够用自然语言提问，并获得由Yelp最新商业数据和评论支持的实时、上下文相关的答案。

🚀 快速开始

Yelp Fusion AI的MCP服务器能让开发者轻松将Yelp的商业数据和对话式智能集成到应用中。以下是使用该服务器的基本步骤：

1. 确保满足先决条件，获取必要的API密钥。
2. 完成服务器的设置和安装。
3. 选择合适的方式运行服务器。

✨ 主要特性

Fusion AI功能

• 下一代搜索与发现：使用自然语言进行搜索，发现并连接上下文相关的商家。例如：“在湾区找到最好吃的玉米饼”。
• 多轮对话：支持来回交互，并通过后续问题细化查询。例如：“这些选项中哪些有露天座位？”
• 直接商业查询：无需事先搜索，即可针对商家提出有针对性的问题。例如：“瑞奇的玉米饼店允许带宠物吗？”
• 对话式餐厅预订：通过自然语言交互探索餐厅的可用性并预订餐桌。请注意，此功能仅可通过申请使用。要启用预订功能，请联系我们。例如：“明天晚上8点在瑞奇的餐厅预订一张4人桌”。

工具

此服务器提供了一个主要工具：

• yelp_agent：专为代理间通信而设计。该工具处理关于本地商家的自然语言请求，提供自然语言响应和结构化的商业数据。它支持使用chat_id进行后续提问。其功能包括商家搜索、详细问题查询、比较、行程规划等，借助了Yelp的数据集。 关键参数：
  • natural_language_query（字符串）：您的查询内容（例如：“在湾区找到最好吃的玉米饼”）。
  • search_latitude（浮点数或空值）：用于特定位置搜索的纬度。
  • search_longitude（浮点数或空值）：用于特定位置搜索的经度。
  • chat_id（字符串或空值）：用于继续之前对话的ID。

📦 安装指南

先决条件

您需要一个容器管理器（如 Docker 或 Podman），或者在本地安装以下内容：

• Python：版本3.10或更高（如pyproject.toml中所指定）。
• uv：Python包管理器。您可以在 https://docs.astral.sh/uv/ 找到安装说明。

您还需要一个Yelp Fusion AI的API密钥。您可以在此创建一个应用来获取密钥，这将开启您的免费试用。如果您需要更多时间进行评估，请发送电子邮件至 fusion@yelp.com 以延长试用期。

更多详细信息和 Yelp Fusion AI的全面文档请点击此处。

安装步骤

1. 克隆仓库：

git clone <repository_url>
cd yelp-mcp

2. 安装依赖项：此命令将创建一个虚拟环境（如果不存在），安装pyproject.toml和uv.lock中定义的所有必要依赖项，并将项目安装到uv环境中。

make install

构建Docker镜像（可选）

如果您更喜欢在容器中运行服务器，可以构建一个Docker镜像：

docker build -t mcp-yelp-agent .

这将创建一个名为mcp-yelp-agent:latest的镜像。

💻 使用示例

运行服务器

本仓库旨在作为 Model Context Protocol服务器 运行。您需要一个MCP客户端（如兼容版本的Claude、Cursor或支持MCP的VS Code）来与之交互。

方法1：不使用Docker运行

确保您已完成“设置和安装”步骤，特别是安装项目，以便mcp-yelp-agent脚本可用。

服务器配置

服务器支持多种传输协议，可以通过命令行参数进行配置。虽然stdio是大多数MCP客户端的主要传输方式，但还有其他选项可用于不同的用例。

• --transport：选择通信协议。
  • stdio（默认）：标准输入/输出，适用于本地工具。
  • streamable-http：可流式传输的HTTP。
  • sse：服务器发送事件。
• --host：要绑定的主机地址（例如：127.0.0.1 或 0.0.0.0）。默认为127.0.0.1。
• --port：要监听的端口。默认为8000。

在MCP客户端中使用以下JSON设置来以默认的stdio传输方式运行服务器：

{
  "mcpServers": {
    "yelp_agent": {
      "command": "uv",
      "args": [
        "--directory",
        "<PATH_TO_YOUR_CLONED_PROJECT_DIRECTORY>",
        "run",
        "mcp-yelp-agent"
      ],
      "env": {
        "YELP_API_KEY": "<YOUR_YELP_FUSION_API_KEY>"
      }
    }
  }
}

注意事项：

• 请将<PATH_TO_YOUR_CLONED_PROJECT_DIRECTORY>替换为您克隆此项目的绝对路径。
• 请将<YOUR_YELP_FUSION_API_KEY>替换为您实际的Yelp Fusion API密钥。
• 如果您的MCP客户端在直接调用uv时遇到问题，可能需要提供uv二进制文件的完整路径。您可以在终端中运行which uv来找到该路径。

方法2：使用Docker运行

确保您已按照“构建Docker镜像”部分的说明构建了Docker镜像。

在MCP客户端中使用以下JSON设置：

{
  "mcpServers": {
    "yelp_agent": {
      "command": "docker",
      "args": [
        "run",
        "-i",          // 交互模式
        "--rm",        // 容器退出时自动移除
        "--init",      // 在容器中以PID 1运行初始化进程
        "-e", "YELP_API_KEY=<YOUR_YELP_FUSION_API_KEY>",
        "mcp-yelp-agent:latest" // 之前构建的镜像名称
      ]
    }
  }
}

注意事项：

• 请将<YOUR_YELP_FUSION_API_KEY>替换为您实际的Yelp Fusion API密钥。
• 如果您的MCP客户端在从系统路径调用docker时遇到问题，可能需要提供其二进制文件的完整路径（例如，运行which docker）。