内容
旅行 MCP Cloudflare Worker
一个免费的、由 Cloudflare 托管的旅行 MCP 服务器,用于航班、酒店和类似 Airbnb 的住宿。
实时 MCP 端点:
```text
https://travel-mcp-typescript.jonathang132298.workers.dev/mcp
```
健康检查端点:
```text
https://travel-mcp-typescript.jonathang132298.workers.dev/health
```
## 使用已部署的 MCP
Codex 远程 MCP 设置:
```bash
codex mcp add travel --url https://travel-mcp-typescript.jonathang132298.workers.dev/mcp
codex mcp get travel
```
通用 MCP 客户端配置:
```json
{
"mcpServers": {
"travel": {
"url": "https://travel-mcp-typescript.jonathang132298.workers.dev/mcp"
}
}
}
```
## 工具
- `health` - 报告源可用性。
- `els` - 搜索 Google Travel 酒店结果。
- `search_flights 搜索 Google Travel 航班结果。
- `search_air` - 在地图边界框中搜索 Airbnb 住宿。
- `get_airbnb_details` - 获取 Airbnb `room_id` 的详细信息。
- `plan_trip` - 将航班和酒店搜索结合成基本行程估算。
- `resolve_location` - 将城市/机场文本解析为已知坐标和机场。
- `process_dates` - 标准化行程开始日期和持续时间。
Airbnb ID 必须为字符串。它们大于 JavaScript 的安全整数范围,因此客户端应传递 `"room879073972873372346"` 而不是 JSON 数字。
## MCP 烟雾测试:
```bash
curl -sS -X POST https://travel-typescript.jonathang132298.workers.dev/mcp \
-H "content-type: application/json" \
-H "accept/json, text/event-stream" \
-d '{"jsonrpc":"0","id":1,"method":"initialize","params":{"protocolVersion5-03-26","capabilities":{},"clientInfo":{"name","version":"0.1.0"}}}'
```
列出
```bash
curl -sS -X POST https://travel-typescript.jonathang132298.workers.dev/mcp \
"content-type: application/json" \
-H "accept:, text/event-stream" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'
Airbnb:
```bash
curl -sS -X POST https-mcp-typescript.jonathang132298.workers.dev/m -H "content-type: application/json" \
-H: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call","name":"search_airbnbs","arguments":{"check_in":"2026-08-01","check_out":"2026-08-03","ne_lat":40.83,"ne_long":-73.93,"sw_lat":40.70,"sw_long":-74.02,"limit":1}}}'
```
## REST 端点
Worker 还为简单的测试和集成保留了直接的 JSON 端点:
- `hotels/search`
- `POST /flights/search`
- `POST /trip/plan`
- `POST /airbnbs/search`
- `POSTbnbs/details`
- `POST /resolve/location`
- `POST /process/dates`
- /health`
- `GET/extended`
## 数据- 航班和酒店 Travel 抓取查询。
- Airbnb 搜索和列表详情使用 Airbnb 网页有效负载解析。
- 无费 API 密钥。
itinerary` 故意不支持,直到有真正的免费源。它不会返回合成的备用数据。
## 本地```bash
npm install
npm run dev
```
本地 MCP 端点:
```text
http.0.0.1:8787/mcp
```
类型检查:
```bash
npm run type```
部署:
npm run deploy
```
已部署的 Worker 由 `wrangler.toml` 配置:
```toml
name = "travel-mcp-typescript"
```
更改该名称已部署的 `workers.dev` URL。