使用说明
塔蒂尔塞佩蒂酒店搜索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的区域IDsubRegionId（数字，可选）：子区域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"
}
]
}
工作流示例
-
搜索目的地：
User: "Antalya'da otel bul" → search_destination(query: "antalya") → Returns: regionId: 34 -
列出酒店：
→ 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 │
└─────────────────┘
许可证
麻省理工学院
