美第奇酒店MCP服务器
一种模型上下文协议（MCP）服务器，提供对美第奇酒店预订和管理系统的访问。该服务器使人工智能助手能够通过Medici hotels API搜索酒店、管理预订和访问酒店数据。
特性
🔍 搜索和数据工具（6）
- get_instant_search_price -按日期和地点搜索酒店价格
- get_rooms_active -使用过滤器获取活动房间列表
- get_rooms_sales -获取客房销售数据和分析
- get_rooms_cancel -获取已取消的房间信息
- 获取机会 -查找预订机会和优惠
- get_room_archive_data -访问历史房间数据
📋 预订管理工具（4）
- 插入机会 -创造新的预订机会
- update_rooms_active_push_price -更新房间价格
- cancel_room_active -取消正在进行的客房预订
- 手册_书籍_房间 -手动为客人预订房间
配置
所需配置
- mediciToken：您的Medici Hotels JWT身份验证令牌（必填）
- mediciBaseUrl：API基本URL（默认为
https://medici-backend.azurewebsites.net)
获取JWT代币
- 登录您的Medici Hotels管理面板
- 导航到API设置或用户配置文件
- 生成或复制您的JWT身份验证令牌
- 在MCP服务器配置中使用此令牌
配置示例
对于Smithery
{
"mediciToken": "your-jwt-token-here",
"mediciBaseUrl": "https://medici-backend.azurewebsites.net"
}适用于克劳德桌面
{
"mcpServers": {
"medici-hotels": {
"command": "npx",
"args": ["-y", "@your-org/medici-hotels-mcp"],
"env": {
"MEDICI_TOKEN": "your-jwt-token-here",
"MEDICI_BASE_URL": "https://medici-backend.azurewebsites.net"
}
}
}
}使用示例
搜索酒店
// Search for hotels in Dubai for June 2025
await get_instant_search_price({
dateFrom: "2025-06-10",
dateTo: "2025-06-17",
city: "Dubai",
adults: 2,
stars: 4
});获得活跃的房间
// Get active rooms with filters
await get_rooms_active({
startDate: "2025-06-01",
endDate: "2025-06-30",
city: "Dubai",
hotelStars: 4
});创建预订机会
// Create a new booking opportunity
await insert_opportunity({
startDateStr: "2025-06-10",
endDateStr: "2025-06-17",
boardId: 1,
categoryId: 2,
buyPrice: 200,
pushPrice: 250,
maxRooms: 5
});安全
- 永远不要将JWT令牌提交给版本控制
- 使用环境变量或安全配置安全地存储令牌
- 代币有到期日-定期续订
- 为开发和生产环境使用不同的令牌
API费率限制
- 每个令牌每分钟120个请求
- 每个令牌每小时5000个请求
- 费率限制会自动执行
错误处理
服务器为以下对象提供详细的错误消息：
- JWT令牌无效或过期
- API请求频率超限
- 无效的请求参数
- 网络连接问题
- 酒店预订冲突
发展
# Install dependencies
npm install
# Build the project
npm run build
# Run locally
npm start许可证
MIT许可证-有关详细信息，请参阅许可证文件。