hotpepper-gourmet-mcp-server

hotpepper-gourmet-mcp-server This application is an unofficial MCP server that utilizes the [Recruit WEB Service Hotpepper Gourmet](https://webservice.recruit.co.jp/doc/hotpepper/reference.html) provided by Recruit Co., Ltd. ## Quick Start ### Installation Methods #### Homebrew ```sh brew install miyamo2/tap/hotpepper-gourmet-mcp-server ``` #### Go ```sh go install github.com/miyamo2/hotpepper-gourmet-mcp-server@latest ``` #### Download from Release Page https://github.com/miyamo2/hotpepper-gourmet-mcp-server/releases/latest ### Usage #### 1. Obtain the API Key for Recruit WEB Service To obtain the API key for Recruit WEB Service, please apply [here](https://webservice.recruit.co.jp/register). #### 2. Configure the MCP Server Configure the installed hotpepper-gourmet MCP server to be callable from the MCP host. Please add the hotpepper-gourmet MCP server in the `mcpServers` section. ※ The format and storage location of the configuration file may vary depending on the MCP host used. ```json5 { "mcpServers": { "hotpepper-gourmet-mcp-server": { "command": "hotpepper-gourmet-mcp-server", "env": { "HOTPEPPER_GOURMET_API_KEY": "<Hotpepper Gourmet API Key>" } } } } ``` ## Features ### Tools #### `gourment_search` Executes the Hotpepper Gourmet gourmet search API. #### `shop_search` Executes the Hotpepper Gourmet shop name search API. #### `large_area_search` Executes the Hotpepper Gourmet large area master API. #### `middle_area_search` Executes the Hotpepper Gourmet middle area master API. #### `small_area_search` Executes the Hotpepper Gourmet small area master API. #### `genre_search` Executes the Hotpepper Gourmet genre master API. #### `dinner_budget_master_search` Executes the Hotpepper Gourmet search dinner budget master API. #### `large_service_area_master_search` Executes the Hotpepper Gourmet large service area master API. #### `service_area_master_search` Executes the Hotpepper Gourmet service area master API. #### `credit_card_master_search` Executes the Hotpepper Gourmet credit card master API. ### Resources #### `dinner_budget_master` Obtains the Hotpepper Gourmet search dinner budget master. #### `large_service_area_master` Obtains the Hotpepper Gourmet large service area master. #### `service_area_master` Obtains the Hotpepper Gourmet service area master. #### `credit_card_master` Obtains the Hotpepper Gourmet credit card master. ## License **hotpepper-gourmet-mcp-server** is developed and distributed under the [MIT License](https://github.com/miyamo2/hotpepper-gourmet-mcp-server/blob/main/LICENSE). ## Disclaimer The author and contributors are not responsible for any defects, damages, or disputes arising between users and Recruit Co., Ltd. due to the use of this application.