Tabelog MCP服务器
一个模型上下文协议（MCP）服务器，使用Playwright和TypeScript从Tabelog中抓取餐厅数据。
特性
- 从Tabelog淘汰顶级餐厅
- 支持不同地区（京都、东京、大阪等）
- 拍摄Tabelog页面的快照
- 提取餐厅名称、评级、网址、菜肴类型、价格和地点
- 按晚餐价格范围筛选价格（日元）
- 用于生产部署的可流化HTTP传输
- STDIO交通促进地方发展
安装
- 安装依赖项：
npm install- 安装Playwright浏览器：
npx playwright install chromium- 构建项目：
npm run buildMCP配置
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）。默认值：10priceRange（对象，可选）：按晚餐价格范围过滤价格
- 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”
使用示例
- 了解京都十大餐厅：
- 工具： tabelog_top - 参数： {"region": "kyoto", "limit": 10}
- 通过价格筛选获得京都排名前20的餐厅：
- 工具： tabelog_top - 参数： {"region": "kyoto", "limit": 20, "priceRange": {"min": 30000, "max": 50000}}
- 东京高档餐厅（50000日元以上）：
- 工具： tabelog_top - 参数： {"region": "tokyo", "limit": 10, "priceRange": {"min": 50000}}
- 拍摄大阪餐厅页面快照：
- 工具： 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许可证获得许可-请参阅 许可证 文件以获取详细信息。