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）。