AI导哈

旅游预订管理服务

Odybook MCP服务器是一个专业级的模型上下文协议实现，使AI助手能够直接与Odybook的体验管理平台交互，提供旅游搜索、实时可用性验证和预订管理功能。

  • by Odybook
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Odybook/odybook-mcp

使用说明

Odybook模型上下文协议（MCP）服务器

Odybook模型上下文协议（MCP）的专业级实现，使AI助手能够直接与Odybook的体验管理平台进行交互。该服务器充当安全代理，为旅游搜索、可用性验证和预订管理提供人工智能工具。

概述

Odybook MCP服务器允许AI模型（如Claude和ChatGPT）在Odybook平台上执行实时操作。它实现了标准的MCP工具包，确保与任何符合MCP的客户端兼容。

特性

  • 经验搜索：按地点和日期发现旅游和活动。
  • 实时可用性：验证特定日期和客人数量的插槽容量。
  • 预订管理：为客户创建临时预订保留。
  • 安全集成：使用Odybook合作伙伴API身份验证。

先决条件

  • Node.js 18.x或更高版本
  • 一个活跃的Odybook合作伙伴API密钥
  • Odybook API URL（默认值： https://odybook.com/api)

安装

  1. 克隆存储库并导航到以下目录：

    cd odybook-mcp

  2. 安装依赖项：

    npm install

  3. 构建项目：

    npm run build

配置

服务器需要以下环境变量。您可以在 .env 文件以供开发，或将其直接传递给MCP客户端。

变量 描述
ODYBOOK_API_KEY （可选）您的合作伙伴API密钥用于受保护的路线，如预订保留。
ODYBOOK_API_URL Odybook API端点（默认值： https://odybook.com/api).

客户端集成

克劳德桌面版

Claude Desktop为MCP服务器提供本机支持。要集成Odybook：

  1. 找到您的Claude Desktop配置文件：

    • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
    • 窗户： %APPDATA%\Claude\claude_desktop_config.json

  2. 将以下内容添加到 mcpServers 对象：

{
  "mcpServers": {
    "odybook": {
      "command": "node",
      "args": ["/absolute/path/to/odybook-mcp/dist/index.js"],
      "env": {
        "ODYBOOK_API_KEY": "YOUR_API_KEY_HERE",
        "ODYBOOK_API_URL": "https://odybook.com/api"
      }
    }
  }
}
  1. 重新启动克劳德桌面。

ChatGPT（自定义GPT）

要将Odybook与ChatGPT一起使用，您可以将Odybok后端用作自定义操作。

  1. 开放规范：使用提供的OpenAPI规范 specs/openapi.json.
  2. 创建动作：在自定义GPT配置中，在“操作”下，单击“创建新操作”。
  3. 导入架构：粘贴以下内容 specs/openapi.json.
  4. 认证：认证类型选择“API Key”，认证方案选择“Bearer”。粘贴您的 ODYBOOK_API_KEY.
  5. 测试：ChatGPT现在可以通过以下方式调用Odybook工具 /api/mcp 桥。

市场提交

该服务器旨在满足官方MCP注册表的要求：

  • 安全注释：所有工具都包含清晰的描述，并遵循安全最佳实践。
  • 供应商中立性：实现没有专有扩展的标准模型上下文协议。
  • 可移植性：已验证可通过Node.js在macOS和Windows上运行。

提交链接

工具参考

search_tours

按地点和日期搜索体验。

  • 参数:
    • location （字符串，可选）：城市或国家名称。
    • date （字符串，可选）：目标日期 YYYY-MM-DD 格式。

check_availability

验证某个体验在给定日期是否有足够的容量。

  • 参数:
    • experience_id （string）：体验的UUID。
    • date （字符串）：日期 YYYY-MM-DD 格式。
    • time （字符串，可选）：特定时隙（例如“10:00”）。
    • pax （number）：客人数量。

create_booking_hold

启动临时预订暂停。

  • 参数:
    • experience_id （string）：体验的UUID。
    • date （string）：目标日期。
    • time （string）：特定时间段（例如“14:00”）。
    • pax （number）：客人数量。
    • customer_name （string）：客户的全名。
    • customer_email （string）：客户的电子邮件地址。

发展

在开发模式下运行服务器并自动重新加载：

npm run dev

安全

此服务器不存储任何客户数据。所有请求都直接代理到Odybook后端。确保您的 ODYBOOK_API_KEY 保持安全，从不致力于版本控制。

相关 MCP