Tabelog MCP

Tabelog MCP服务器

一个模型上下文协议（MCP）服务器，使用Playwright和TypeScript从Tabelog中抓取餐厅数据。


特性

• 从Tabelog淘汰顶级餐厅
• 支持不同地区（京都、东京、大阪等）
• 拍摄Tabelog页面的快照
• 提取餐厅名称、评级、网址、菜肴类型、价格和地点
• 按晚餐价格范围筛选价格（日元）
• 用于生产部署的可流化HTTP传输
• STDIO交通促进地方发展

安装

1. 安装依赖项：

npm install

1. 安装Playwright浏览器：

npx playwright install chromium

1. 构建项目：

npm run build

MCP配置

HTTP传输（推荐）

将此添加到MCP主机配置中：

{
  "mcpServers": {
    "tabelog": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

STDIO交通（发展）

{
  "mcpServers": {
    "tabelog": {
      "command": "node",
      "args": ["dist/src/index.js", "--stdio"]
    }
  }
}

可用工具

tabelog_top

从Tabelog获取特定地区的顶级餐厅。

参数：

• region （string）：区域slug（例如，“京都”、“东京”、“大阪”）。默认值：“kyoto”
• limit （整数）：要返回的餐厅数量（1-20）。默认值：10
• priceRange （对象，可选）：按晚餐价格范围过滤价格

- min （整数）：最低晚餐价格（日元） - max （整数）：最高晚餐价格（日元）

示例：

// Basic usage
{
  "region": "kyoto",
  "limit": 10
}

// With price filtering
{
  "region": "kyoto",
  "limit": 20,
  "priceRange": {
    "min": 30000,
    "max": 50000
  }
}

// High-end restaurants only
{
  "region": "kyoto",
  "limit": 10,
  "priceRange": {
    "min": 50000
  }
}

tabelog_snapshot

为特定区域的Tabelog页面拍摄快照。

参数：

• region （string）：区域slug（例如，“京都”、“东京”、“大阪”）。默认值：“kyoto”

使用示例

1. 了解京都十大餐厅：

- 工具： tabelog_top - 参数： {"region": "kyoto", "limit": 10}

1. 通过价格筛选获得京都排名前20的餐厅：

- 工具： tabelog_top - 参数： {"region": "kyoto", "limit": 20, "priceRange": {"min": 30000, "max": 50000}}

1. 东京高档餐厅（50000日元以上）：

- 工具： tabelog_top - 参数： {"region": "tokyo", "limit": 10, "priceRange": {"min": 50000}}

1. 拍摄大阪餐厅页面快照：

- 工具： tabelog_snapshot - 参数： {"region": "osaka"}

响应格式

这 tabelog_top 工具返回一个JSON对象，其中包含：

• region：请求的区域
• count：退回的餐馆数量
• restaurants：餐厅对象数组，每个对象包含：

- name：餐厅名称 - rating：标签评级 - url：Tabelog上的餐厅URL - cuisine：菜肴类型 - location：最近的车站/区域 - price：价格范围 - rank：排名位置

发展

运行服务器

# Development mode (HTTP transport)
npm run dev

# Development mode (STDIO transport)
npm run dev:stdio

# Production mode
npm start

项目结构

src/
├── index.ts            # Main entry point
├── cli.ts              # Command-line argument parsing
├── config.ts           # Configuration management
├── server.ts           # Server instance creation
├── client.ts           # Playwright client for Tabelog scraping
├── types.ts            # TypeScript type definitions
├── tools/
│   ├── index.ts        # Tool exports
│   └── tabelog.ts      # Tool definitions and handlers
└── transport/
    ├── index.ts        # Transport exports
    ├── http.ts         # HTTP transport (primary)
    └── stdio.ts        # STDIO transport (development)

备注

• 服务器在无头模式下使用Playwright和Chromium
• 餐厅数据使用Tabelog的评分（最高排名第一）进行排序 SrtT=rt 参数
• 价格过滤通过URL参数和客户端过滤来实现可靠性
• 每页最多20家餐厅（根据Tabelog分页）
• scraper使用健壮的选择器来避免脆弱的类名
• 实施了限速和尊重的抓取做法
• 遵循MCP服务器指南，提供流式HTTP传输
• 基于TypeScript实现更好的类型安全性和可维护性

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。