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)
安装
- 克隆存储库并导航到以下目录：
cd odybook-mcp- 安装依赖项：
npm install- 构建项目：
npm run build配置
服务器需要以下环境变量。您可以在 .env 文件以供开发，或将其直接传递给MCP客户端。
| 变量 | 描述 |
|---|---|
ODYBOOK_API_KEY | （可选）您的合作伙伴API密钥用于受保护的路线，如预订保留。 |
ODYBOOK_API_URL | Odybook API端点（默认值： https://odybook.com/api). |
客户端集成
克劳德桌面版
Claude Desktop为MCP服务器提供本机支持。要集成Odybook：
- 找到您的Claude Desktop配置文件：
- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json
- 将以下内容添加到
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"
}
}
}
}- 重新启动克劳德桌面。
ChatGPT（自定义GPT）
要将Odybook与ChatGPT一起使用，您可以将Odybok后端用作自定义操作。
- 开放规范：使用提供的OpenAPI规范
specs/openapi.json. - 创建动作：在自定义GPT配置中，在“操作”下，单击“创建新操作”。
- 导入架构：粘贴以下内容
specs/openapi.json. - 认证：认证类型选择“API Key”，认证方案选择“Bearer”。粘贴您的
ODYBOOK_API_KEY. - 测试：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 保持安全，从不致力于版本控制。