hotpepper-gourmet

The hotpepper-gourmet-mcp-server is an MCP server that exposes the Hot Pepper Gourmet API set through a Modular Communication Protocol (MCP) interface. It acts as a backend provider that translates MCP requests into calls to Recruit’s Hot Pepper Gourmet web services, such as restaurant searches, area master lookups, and master data retrieval. The server supports a collection of tools (functions) that you can invoke via MCP to fetch data like gourmet search results, shop names, and various master data for areas, genres, budgets, and payment methods. To use it, configure your MCP host to point to the hotpepper-gourmet-mcp-server binary (or container) and supply your API key via the HOTPEPPER_GOURMET_API_KEY environment variable as shown in the example configuration. Once running, MCP clients can request data by calling the supported tools and receiving structured responses.

Prerequisites:

• Go tooling installed (to build or install the server)
• Access to the internet to download dependencies

Installation steps (examples from the README):

1. Install via Homebrew (macOS): brew install miyamo2/tap/hotpepper-gourmet-mcp-server

2. Install using Go tooling (binary build): go install github.com/miyamo2/hotpepper-gourmet-mcp-server@latest

3. Alternatively, download the latest release from GitHub: https://github.com/miyamo2/hotpepper-gourmet-mcp-server/releases/latest

Note: After installation, run the binary as configured in your MCP host setup and provide the API key via the HOTPEPPER_GOURMET_API_KEY environment variable. The exact invocation may vary depending on your MCP host configuration.

Tips and considerations:

• You must obtain a Hot Pepper Gourmet API key from Recruit’s web service portal and set it in the HOTPEPPER_GOURMET_API_KEY environment variable when configuring the MCP server.
• In your MCP host configuration, ensure the mcpServers entry uses the binary name hotpepper-gourmet-mcp-server and that the API key is supplied through env as shown.
• The server exposes tools such as gourmet_search, shop_search, large_area_search, middle_area_search, small_area_search, genre_search, dinner_budget_master_search, large_service_area_master_search, service_area_master_search, and credit_card_master_search, along with corresponding resources for retrieving masters.
• If you encounter API rate limits or authentication errors, verify your API key is active and that the MCP host is correctly routing requests to the server.
• The exact data formats and required parameters for each tool are defined by the underlying Hot Pepper Gourmet API; consult the official documentation for parameter schemas.