Jinko MCP

🚀 酒店預訂MCP服務器

本項目是首個可接入200萬家酒店，具備搜索和預訂功能的MCP服務器。你可以集成我們的MCP，在數分鐘內即可讓你的代理開始銷售酒店服務。如需使用生產版本，請訪問我們的網站https://www.jinko.so/ 進行申請。歡迎隨時聯繫我們！

MCP（模型上下文協議）是一種開放協議，它規範了應用程序如何向大語言模型（LLMs）提供上下文，可將其視為AI應用的USB - C端口，用於連接模型與外部數據源和工具。

🚀 快速開始

本項目可直接集成使用，若需使用生產環境並獲取銷售佣金，請通過網站https://www.jinko.so/ 聯繫我們。以下是一些基本的啟動和使用步驟。

✨ 主要特性

1. 地點查找：將用戶的地點查詢轉換為帶有座標的標準化地點信息。
2. 酒店搜索：根據地點座標和預訂要求搜索可用酒店。
3. 酒店詳情獲取：獲取特定酒店的全面詳細信息。
4. 酒店預訂：通過創建報價並返回支付鏈接來預訂酒店。
5. 設施獲取：以不同語言檢索酒店設施，用於篩選搜索結果。

📦 安裝指南

目前你可以在本地安裝我們的MCP，遠程支持即將推出。安裝命令如下：

{
  "mcpServers": {
    "jinko-travel": {
      "command": "npx",
      "args": [
        "jinko-mcp-dev@latest"
      ]
    }
  }
}

你也可以全局安裝該包：

npm install -g jinko-mcp-dev

或者直接使用npx運行：

npx jinko-mcp-dev

💻 使用示例

啟動服務器

使用npm

npm run start

使用npx（發佈後）

npx jinko-mcp-dev

該MCP服務器使用標準輸入輸出傳輸，這意味著它可以直接與支持此傳輸類型的MCP客戶端一起使用。

工具使用

1. find - place

將用戶的地點查詢轉換為帶有座標的標準化地點信息。 參數：

• query：用戶用於地點搜索的輸入（例如，'New York'、'Paris'、'Tokyo'）
• language（可選）：地點搜索的語言，默認值：'en'

當你僅擁有文本描述但需要酒店搜索的經緯度時，此工具至關重要。它接受城市名稱、酒店名稱、地標或其他地點標識符，並返回匹配地點的列表及其詳細信息和精確座標。

2. search - hotels

根據地點座標和預訂要求搜索可用酒店。 參數：

• latitude：地點的緯度
• longitude：地點的經度
• check_in_date：入住日期（YYYY - MM - DD），默認值：'2025 - 06 - 25'
• check_out_date：退房日期（YYYY - MM - DD），默認值：'2025 - 06 - 26'
• adults：成人數量，默認值：2
• children：兒童數量，默認值：0
• facilities（可選）：用於篩選酒店的設施ID，這些ID可以通過設施資源推斷得出

此工具返回一個分頁的酒店列表，包含酒店的關鍵詳細信息，如名稱、地址、星級、價格範圍和可用房型。每家酒店都包含有關設施和可用房價的摘要信息。每次請求的結果限制為50家酒店。

3. load - more - hotels

使用會話ID從先前的搜索中檢索更多酒店結果。 參數：

• session_id：先前搜索酒店或加載更多酒店響應中的會話ID

此工具從先前的搜索酒店請求繼續分頁，返回與原始搜索相同格式和詳細信息的下一批酒店。

4. get - hotel - details

檢索由其ID標識的特定酒店的全面詳細信息。 參數：

• session_id：先前搜索的會話ID
• hotel_id：要獲取詳細信息的酒店ID

此工具提供比搜索結果中更廣泛的信息，包括完整描述、所有可用房型、詳細的房價信息、取消政策和完整的設施列表。

5. book - hotel

為特定酒店和房價選項啟動酒店預訂流程。 參數：

• session_id：先前搜索的會話ID
• hotel_id：要預訂的酒店ID
• rate_id：用戶選擇的特定房價選項的ID

此工具為指定的酒店和房間創建預訂報價，並返回一個支付鏈接，供用戶完成預訂。

6. get - facilities

以指定語言檢索酒店設施列表。 參數：

• language：設施名稱的語言代碼（en、es、it、he、ar、de），默認值：'en'

每當用戶提及特定酒店設施或要求時，必須在使用search - hotels之前調用此工具。它返回設施ID，這些ID必須與search - hotels工具的facilities參數一起使用，以正確篩選酒店。

📚 詳細文檔

資源

標準服務器以多種語言提供酒店設施數據作為資源：

• 英語（en）
• 西班牙語（es）
• 意大利語（it）
• 希伯來語（he）
• 阿拉伯語（ar）
• 德語（de）

這些資源可以使用hotel://facilities/{language} URI模式訪問，其中{language}是支持的語言代碼之一。

設施數據

服務器包含內置的設施數據，用於提供有關酒店設施的信息。此數據用於根據用戶請求的特定設施篩選酒店搜索。

每個設施包括：

• facility_id：設施的唯一標識符
• facility：設施的英文名稱
• sort：顯示的排序順序
• translation：不同語言的翻譯數組

使用get - facilities工具時，可用設施作為響應的一部分返回，允許大語言模型在使用search - hotels工具篩選酒店搜索時使用適當的設施ID。

工作流示例

使用標準服務器的典型工作流程如下：

1. 使用find - place將用戶的地點查詢轉換為座標。
2. 使用get - facilities識別用戶請求的任何設施的設施ID。
3. 使用search - hotels結合座標和設施ID查找匹配的酒店。
4. 如果初始的50個結果不夠，使用load - more - hotels獲取更多結果。
5. 使用get - hotel - details檢索特定酒店的全面信息。
6. 使用book - hotel啟動預訂流程並生成支付鏈接。

發佈到npm

要將此包發佈到npm，請按照以下步驟操作：

1. 確保你有一個npm賬戶並已登錄：

   npm login
   

2. 更新package.json中的版本號：

   npm version patch  # 或minor或major
   

3. 構建項目：

   npm run build
   

4. 發佈到npm：

   npm publish
   

發佈後，用戶可以按照安裝部分所述使用npm或npx安裝和運行該包。

📄 許可證

原文檔未提及許可證相關信息。