项目简介

本项目是基于 Model Context Protocol (MCP) 实现的一个 MCP 服务器，通过调用株式会社リクルート提供的 HotPepper 美食 WEB 服务 API，为 MCP 客户端 (通常是大型语言模型 LLM) 提供丰富的餐厅相关数据和搜索能力。

主要功能点

• 餐厅搜索: 允许 LLM 根据店铺 ID、名称、地址、关键词、区域（大、中、小服务区及具体区域）、经纬度、距离范围、类型、预算、容纳人数以及各种设施条件（如 Wifi、包间、无烟、停车、信用卡等）进行精细化搜索。
• 店铺搜索: 支持根据店铺名称或电话号码进行搜索。
• 地域信息查询: 提供 HotPepper API 定义的大、中、小区域列表及对应的代码信息。
• 行业分类查询: 提供餐厅行业（Genre）的列表及对应的代码信息。
• 基础数据获取: 提供用餐预算、服务区域、信用卡类型等基础主数据列表，供 LLM 作为上下文参考。

安装步骤

您可以选择以下任一方式安装本服务器：

1. 使用 Homebrew (macOS/Linux):

   brew install miyamo2/tap/hotpepper-gourmet-mcp-server
   

2. 使用 Go 工具链:

   go install github.com/miyamo2/hotpepper-gourmet-mcp-server@latest
   

3. 从 Release 页面下载: 访问项目的 GitHub Releases 页面，下载与您操作系统和架构对应的二进制文件。

服务器配置

本 MCP 服务器需要一个有效的 HotPepper 美食 WEB 服务 API 密钥 才能正常工作。您需要在启动本服务器的 MCP 客户端或主机环境中进行配置。

在您的 MCP 客户端/主机的配置文件（具体格式和位置取决于您使用的 MCP 客户端）中，找到用于定义外部 MCP 服务器的部分（通常是 'mcpServers'）。您需要为 'hotpepper-gourmet-mcp-server' 添加一个条目，指定如何启动它以及传递必要的 API 密钥。

通常，配置会包含：

• 一个识别此服务器的名称，例如 'hotpepper-gourmet-mcp-server'。
• 用于启动服务器的命令 ('command')，例如 'hotpepper-gourmet-mcp-server' (如果您通过 Homebrew 或 Go 安装到 PATH 中)。
• 可选的启动参数 ('args')。
• 一个环境变量映射 ('env')，您必须在此处设置 'HOTPEPPER_GOURMET_API_KEY' 环境变量，并将其值设为您从 HotPepper 申请获得的 API 密钥。

重要提示: 请将您真实的 API 密钥替换配置中的占位符。API 密钥的获取请参考 リクルートWEBサービス。

基本使用方法

安装并配置好服务器后，启动您的 MCP 客户端/主机。它将根据配置启动并连接到 'hotpepper-gourmet-mcp-server'。一旦连接建立，您的 LLM 就可以通过 MCP 协议发现此服务器提供的工具和资源。LLM 可以调用这些工具来搜索餐厅或获取基础数据，并将这些信息用于生成更准确、更有用的回复。