POS.DO MCP Server

---

POS.DO 是一个覆盖全球餐厅的发现平台，提供餐厅名称、地址、评价、照片、营业时间、菜系、街区、文化背景，以及包含时段优惠的实时可用情况。此 MCP 服务通过模型上下文协议向 AI Agent 提供该目录。

此服务提供的内容

• 356,780 家餐厅，遍布 20 个国家/地区（US、ES、IT、MX、FR、CO、DE、GB、DO、PR、AU、CA、PT、JP、BE、CH、HK、VE、NZ、PY）
• 7 种语言的内容（ES、EN、IT、FR、DE、PT、CA）
• 14.1M+ 条用户评价，包含作者、评分、文本、语言和照片
• 文化背景 — 每家餐厅附近的纪念碑、博物馆、公园和遗产地信息，数据来自 Wikidata
• Flow 时段优惠 — 参与活动的餐厅提供非高峰时段折扣，并显示真实座位可用情况
• 预订，采用幂等语义（通过 Idempotency-Key 请求头安全重试）

这是一个代理仓库。MCP 端点运行于 https://pos.do/mcp，由 EZZYPUSH SL 运营。无需在本地安装服务 — Agent 只需连接该 URL 即可。

快速开始

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "pos-do": {
      "url": "https://pos.do/mcp"
    }
  }
}

重启 Claude Desktop。即可使用以下 7 个工具。

Cursor / Cline / Continue

大多数 MCP 客户端都接受格式相同的远程 HTTP 服务条目。Cursor 配置示例：

{
  "mcp.servers": {
    "pos-do": {
      "url": "https://pos.do/mcp",
      "transport": "http"
    }
  }
}

通用 MCP 客户端（通过 HTTP 传输原始 JSON-RPC）

curl -sS -X POST https://pos.do/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

工具

工具	用途	文档
search_restaurants	在城市中搜索餐厅，并按菜系／价格／特色筛选	文档
get_restaurant_details	根据 slug 获取餐厅完整资料	文档
get_restaurant_reviews	分页获取评价，并按星级和日期筛选	文档
get_flow_offers	获取餐厅当天的时段折扣名额	文档
book_flow_reservation	预订 Flow 折扣时段的座位	文档
find_restaurants_near_landmark	查找著名地标步行距离范围内的餐厅	文档
get_cultural_context_around_restaurant	获取餐厅附近的纪念碑、博物馆和公园（Wikidata）	文档

完整工具列表及 inputSchema 可通过 /.well-known/mcp.json 实时获取。

端点和传输方式

• 生产环境 URL：https://pos.do/mcp
• 协议：MCP 2024-11-05
• 传输方式：HTTP POST（JSON-RPC 2.0），兼容 Streamable HTTP
• 发现清单：
  • https://pos.do/.well-known/mcp.json — 官方 MCP 发现清单（包含完整的 tools[] 和 inputSchema）
  • https://pos.do/.well-known/webmcp.json — webmcp.link 清单
  • https://pos.do/.well-known/mcp/server-card.json — Smithery 风格的服务卡片
  • https://pos.do/mcp/manifest.json — 别名

身份验证和速率限制

服务器默认运行在匿名层级。无需 API 密钥。

层级	每分钟	每天
匿名（默认）	每个 IP 每分钟 60 次请求	每个 IP 每天 10,000 次请求
预订尝试	每个 IP 每分钟 10 次	每个邮箱每天 5 次

可按需申请更高请求速率的 API 密钥——请提交 issue。

如需确保预订操作具备幂等性，请发送 Idempotency-Key HTTP 标头（任意 UUID 或稳定的客户端密钥）。24 小时内重放请求会返回原预订，而不会创建重复项。

覆盖范围和数据来源

各国家/地区的数据量和来源归属信息，请参见 docs/data-coverage.md。

示例

• Python
• Node
• curl

状态

稳定。目前只接受向后兼容的更改。破坏性更改将通过 CHANGELOG.md 公布，并升级至 2.x。

许可证

Apache License 2.0 — 请参见 LICENSE。

联系方式

• 问题 / 功能请求：github.com/posdo-io/mcp-server/issues
• 运营方：EZZYPUSH SL（西班牙）
• 网站：pos.do