resy MCP

恢复MCP服务器

一种MCP（模型上下文协议）服务器，与Resy的API集成，用于搜索餐馆并查找可用的预订位。返回结构化JSON数据和样式化HTML轮播。

特性

• 搜索餐厅：按餐厅名称/位置和可用性搜索餐厅
• 查找可用地块：查找特定餐厅的可用预订时间
• 带有Resy品牌的HTML轮播输出
• 双传输支持：stdio（用于MCP检查器/本地）和HTTP/SSE（用于远程访问）

设置

1.安装依赖项

npm install

2.获取Resy凭据

您需要从浏览器中提取凭据：

1. 登录 Resy.com
2. 打开浏览器开发工具（F12）
3. 转到“网络”选项卡
4. 搜索餐厅并查看API请求
5. 找到这些值：

- RESY_API_KEY：从 Authorization: ResyAPI api_key="..." 头球 - RESY_AUTH_TOKEN：从 X-Resy-Auth-Token 标题或Cookie

3.配置环境

复制 .env.example 到 .env 并填写您的凭据：

cp .env.example .env

编辑 .env:

RESY_API_KEY=your_api_key_here
RESY_AUTH_TOKEN=your_auth_token_here
PORT=3000

4.构建和运行

npm run build

HTTP/SSE模式 （用于远程访问、ChatGPT等）：

npm start

服务器将于启动 http://localhost:3000.

标准模式 （适用于MCP检查员、Claude Desktop等）：

npm run start:stdio

您还可以使用 --stdio 标志或集合 MCP_TRANSPORT=stdio 环境变量。

运输方式

HTTP/SSE模式（默认）

用于远程访问。使用SSE终结点启动Express服务器。

终点：

• GET /health -健康检查
• GET /sse -MCP通信的SSE端点
• POST /messages -消息处理端点

标准模式

用于本地MCP客户端，如MCP Inspector或Claude Desktop。通过stdin/stdout进行通信。没有启动HTTP服务器。

MCP客户端配置

对于Claude Desktop/stdio客户端：

{
  "mcpServers": {
    "resy": {
      "command": "node",
      "args": ["/path/to/resy-mcp/build/index.js", "--stdio"],
      "env": {
        "RESY_API_KEY": "your_key",
        "RESY_AUTH_TOKEN": "your_token"
      }
    }
  }
}

对于HTTP/SSE客户端：

{
  "mcpServers": {
    "resy": {
      "url": "http://localhost:3000/sse",
      "transport": "sse"
    }
  }
}

工具

搜索餐厅

搜索有空房的餐厅。

参数：

• location （必填）：城市或社区（例如，“纽约”、“SoHo”）
• date （必填）：YYYY-MM-DD格式的日期
• party_size （必填）：客人人数（1-20）
• query （可选）：搜索餐厅名称或菜肴
• time_preference （可选）：首选时间（例如，“晚上7点”、“晚餐”）
• limit （可选）：最大结果（默认值：9）

例子：

{
  "location": "New York",
  "date": "2026-02-14",
  "party_size": 2,
  "time_preference": "7pm"
}

查找可用地块

查找特定餐厅的可用时间。

参数：

• venue_id （必填）：重新设置会场ID
• date （必填）：YYYY-MM-DD格式的日期
• party_size （必填）：客人人数（1-20）
• time_preference （可选）：首选时间

例子：

{
  "venue_id": 12345,
  "date": "2026-02-14",
  "party_size": 2
}

部署

渲染

创建 render.yaml:

services:
  - type: web
    name: resy-mcp
    env: node
    buildCommand: npm install && npm run build
    startCommand: node build/index.js
    envVars:
      - key: RESY_API_KEY
        sync: false
      - key: RESY_AUTH_TOKEN
        sync: false

码头工人

npm run build
docker build -t resy-mcp .
docker run -p 3000:3000 \
  -e RESY_API_KEY=your_key \
  -e RESY_AUTH_TOKEN=your_token \
  resy-mcp

本地与ngrok

npm start
ngrok http 3000

使用ngrok URL进行远程访问。

许可证

麻省理工学院