OKstays

OKstays MCP 服务

找到真正能让你睡个好觉的酒店。OKstays 根据 67 项舒适度指标，为 80 多个目的地的 30,000 多家酒店评分 （高效空调、舒适床铺、真正的隔音效果、安静的夜晚、宽敞的客房、近期翻新、安全且适合步行的街区等），并将这些指标综合为 0 到 10 分的舒适度评分。五项必备条件（干净、床铺舒适、淋浴良好、没有虫害、区域安全）占 40% 的权重，任何一项不达标的酒店都不会上榜。酒店无法付费获得排名。

这是一个托管式、只读的 MCP 服务。无需安装，也无需账号或 API 密钥。

• 端点： https://okstays.com/api/mcp（可流式传输的 HTTP）
• 身份验证： 无
• 文档： https://okstays.com/mcp
• 网站： https://okstays.com

连接

Claude（网页版和桌面版）： Customize → Add → Add custom connector。将其命名为 OKstays，在服务器 URL 中粘贴 https://okstays.com/api/mcp，无需登录，然后连接并允许使用这些工具。所有 Claude 套餐均可使用，包括免费版。

Claude Code：

claude mcp add --transport http okstays https://okstays.com/api/mcp

ChatGPT（网页版）： Connectors → Add → Add custom MCP server。将其命名为 OKstays，粘贴 https://okstays.com/api/mcp， 选择 No authentication，创建并连接。在聊天中选择 OKstays（或输入 @OKstays）。

Cursor（~/.cursor/mcp.json）：

{
  "mcpServers": {
    "okstays": { "url": "https://okstays.com/api/mcp" }
  }
}

VS Code（.vscode/mcp.json）：

{
  "servers": {
    "okstays": { "type": "http", "url": "https://okstays.com/api/mcp" }
  }
}

Cline（MCP 设置）：

{
  "mcpServers": {
    "okstays": { "type": "streamableHttp", "url": "https://okstays.com/api/mcp" }
  }
}

任何客户端，手动配置：

curl -X POST https://okstays.com/api/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

工具

全部八个工具都只读取数据。每个工具的输入、输出和访问级别见：TOOLS.md。

工具	功能
get_city_overview	快速了解目的地：已评分的酒店数量、平均舒适度评分、中位价格、当地酒店最擅长和最不擅长的方面、最佳街区，以及适合的旅行风格
search_hotels	按舒适度评分排序，查找城市中最多 10 家酒店；可按旅行风格（深度睡眠、数字游民、家庭、浪漫、商务、独行、奢华、经济型、避开人群）、必备条件、价格、街区或距地标的距离筛选
get_hotel	查看一家酒店的完整信息：评分明细、每项指标的分数及说明、注意事项、价格和链接
compare_hotels	并排比较两到四家酒店，并给出结论：舒适度最佳、价格最低、性价比最高
find_similar_hotels	查找同一城市中评分最接近指定酒店的酒店；也可筛选更便宜的酒店
list_cities	查看涵盖的目的地及酒店数量；也可限定某个国家
get_filters	查看 search_hotels 中可用的全部舒适度筛选条件和旅行风格
plan_trip	为多站行程（例如里斯本 4 晚、波尔图 3 晚、马德里 5 晚）查找酒店：为每一站提供最佳匹配和备选酒店、入住日期及预估总价，并附上可打开对应酒店页面且包含这些日期的链接

示例提示词

• 里斯本哪些街区的酒店最舒适？
• 找一家波尔图安静的酒店，每晚不超过 200 美元
• 曼谷有哪些酒店配备高效空调和隔音客房？
• 比较排名前两位的酒店，并告诉我哪家性价比更高
• 找一家和第一家类似、但更便宜的酒店
• 规划从 5 月 10 日开始的酒店行程：里斯本 4 晚、波尔图 3 晚、马德里 5 晚

数据、隐私和限制

• 搜索结果会链接到 okstays.com 上各酒店的页面，页面包含照片、地图和价格。价格是以指定日期为例、供两位成人入住的参考价格。用户通过网站上的预订链接预订时，OKstays 会获得佣金；这绝不会影响排名，工具结果也不包含联盟链接。
• 合理使用：每位调用者每分钟最多请求 60 次，每天最多 2,000 次。每次工具调用都会记录（工具、搜索参数、客户端名称、经哈希处理的调用者 ID），并保留 30 天，用于限制请求和防止滥用：https://okstays.com/privacy
• 条款：https://okstays.com/terms
• 支持：[email protected]

关于此存储库

该服务运行在 OKstays 自有基础设施上；其代码不公开。此存储库包含 MCP 目录和 客户端所需的内容：

• 此 README 和 llms-install.md，供人员和 Agent 配置服务；
• server.json，以 com.okstays/okstays 的名称发布到官方 MCP 注册表；
• gemini-extension.json（Gemini CLI）和 .cursor-plugin/plugin.json 以及 mcp.json（Cursor），这些文件仅用于将相应客户端指向该端点；
• 徽标（logo-400.png）。

配置文件和文档采用 MIT 许可证（LICENSE）；OKstays 名称和徽标不在此许可范围内。