Hotel MCP

塔蒂尔塞佩蒂酒店搜索MCP服务器

Tatilspeti酒店搜索功能的模型上下文协议（MCP）服务器。

特性

• 搜索目的地：查找地区和地点
• 列出酒店：使用过滤器获取酒店列表
• 自动令牌管理：自动为每个请求获取新的令牌
• 丰富的酒店数据：包括价格、评级、设施、活动

安装

使用npx（推荐）

npx tatilsepeti-hotel-mcp

来自源头

npm install
# or
yarn install

配置

所需的环境变量

创建 .env 文件或设置环境变量：

API_URL=https://api.tatilsepeti.com/api/v1
API_TOKEN=your_api_token_here
BASE_URL=https://www.tatilsepeti.com

或直接出口：

export API_URL="https://api.tatilsepeti.com/api/v1"
export API_TOKEN="your_api_token"
export BASE_URL="https://www.tatilsepeti.com"

用法

使用Claude桌面版

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "tatilsepeti-hotel": {
      "command": "npx",
      "args": ["tatilsepeti-hotel-mcp"],
      "env": {
        "API_URL": "https://api.tatilsepeti.com/api/v1",
        "API_TOKEN": "your_api_token_here",
        "BASE_URL": "https://www.tatilsepeti.com"
      }
    }
  }
}

手动运行

node mcp.js

可用工具

1.搜索_定位

搜索旅行目的地（地区/地点）。

参数：

• query （string）：目的地名称（例如，“antalya”、“bodrum”、“istanbul”）

退货：

[
  {
    "regionId": 34,
    "subRegionId": 0,
    "type": 0,
    "title": "Antalya"
  }
]

2.列表_酒店

列出特定地区的酒店。

参数：

• regionId （number）：来自search_destination的区域ID
• subRegionId （数字，可选）：子区域ID（默认值：0）
• type （数字，可选）：类型（默认值：0）
• checkinDate （字符串）：入住日期（YYYY-MM-DD）
• checkoutDate （字符串）：退房日期（YYYY-MM-DD）
• adultCount （数字，可选）：成年人数量（默认值：2）
• childCount （数字，可选）：子项数量（默认值：0）
• childAges （数组，可选）：儿童年龄（默认值：\[\]）
• pageNumber （数字，可选）：页码（默认值：1）
• pageSize （数量，可选）：每页酒店数（默认值：20）

退货：

{
  "totalCount": 155,
  "currentPage": 1,
  "pageSize": 20,
  "showingCount": 20,
  "hotels": [
    {
      "name": "Hotel Name",
      "star": 5,
      "score": 8.9,
      "scoreText": "Harika",
      "reviewCount": 150,
      "location": "Kemer, Antalya",
      "price": 10500,
      "discountRate": 30,
      "accommodation": "Her Şey Dahil",
      "campaignName": "Son Dakika %30 İndirim",
      "properties": ["Aquapark", "Spa", "Denize Sıfır"],
      "isFreeCancellation": true,
      "image": "https://cdn.tatilsepeti.com/...",
      "link": "https://www.tatilsepeti.com/hotel-url"
    }
  ]
}

工作流示例

1. 搜索目的地：

   User: "Antalya'da otel bul"
   → search_destination(query: "antalya")
   → Returns: regionId: 34

1. 列出酒店：

   → list_hotels(
       regionId: 34,
       checkinDate: "2025-12-24",
       checkoutDate: "2025-12-27",
       adultCount: 2
     )
   → Returns: 20 hotels with details

包含的功能

• 静态API令牌身份验证
• 酒店链接的查询字符串生成
• 日期格式（YYYY-MM-DD→ DD.MM.YYYY）
• 丰富的酒店详细信息（酒店、活动、评论）
• 分页支持
• 环境变量配置

发展

# Install dependencies
npm install

# Run MCP server
npm start

建筑

┌─────────────────┐
│  Claude/Client  │
└────────┬────────┘
         │ MCP Protocol
         │
┌────────▼────────┐
│   MCP Server    │
│   (mcp.js)      │
└────────┬────────┘
         │
         │ OAuth2 + REST
         │
┌────────▼────────┐
│ Tatilsepeti API │
└─────────────────┘

许可证

麻省理工学院