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安装和运行该包。

📄 许可证

原文档未提及许可证相关信息。