About hotpepper-gourmet-mcp-server
hotpepper-gourmet-mcp-server is an unofficial MCP server for Recruit's Hot Pepper Gourmet web service. It provides search tools and reference data for restaurant discovery and filtering.
Key features
- 01Search gourmet listings
- 02Search by restaurant name
- 03Look up area classifications
- 04Look up genres and dinner budgets
- 05Access service-area and card data
Use cases
- 01Find restaurants using gourmet search
- 02Search for a restaurant by name
- 03Filter restaurant searches by area or genre
MCP support
Exposes Hot Pepper Gourmet search APIs as MCP tools and provides reference data such as budget, service-area, and credit-card masters as resources.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEhotpepper-gourmet-mcp-server
ホットペッパーグルメ MCP Server
このアプリケーションは株式会社リクルートの提供するリクルートWEBサービス ホットペッパーグルメを利用した非公式のMCPサーバーです。
クイックスタート
インストール方法
Homebrew
brew install miyamo2/tap/hotpepper-gourmet-mcp-server
Go
go install github.com/miyamo2/hotpepper-gourmet-mcp-server@latest
リリースページからダウンロード
https://github.com/miyamo2/hotpepper-gourmet-mcp-server/releases/latest
使い方
1. リクルートWEBサービスのAPIキーを取得する
リクルートWEBサービスのAPIキーを取得するにはこちらから申請してください。
2. MCPサーバーを設定する
インストールしたホットペッパーグルメMCPサーバーをMCPホストから呼び出せるよう設定します。
以下のようにmcpServersセクションにホットペッパーグルメMCPサーバーを追加してください。
※ 設定ファイルのフォーマットや保存場所は利用するMCPホストによって異なります。
{
"mcpServers": {
"hotpepper-gourmet-mcp-server": {
"command": "hotpepper-gourmet-mcp-server",
"env": {
"HOTPEPPER_GOURMET_API_KEY": "<Hotpepper Gourmet API Key>"
}
}
}
}
機能
ツール
gourment_search
ホットペッパーグルメのグルメサーチAPIを実行します。
shop_search
ホットペッパーグルメの店名サーチAPIを実行します。
large_area_search
ホットペッパーグルメの大エリアマスタAPIを実行します。
middle_area_search
ホットペッパーグルメの中エリアマスタAPIを実行します。
small_area_search
ホットペッパーグルメの小エリアマスタAPIを実行します。
genre_search
ホットペッパーグルメのジャンルマスタAPIを実行します。
dinner_budget_master_search
ホットペッパーグルメの検索用ディナー予算マスタAPIを実行します。
large_service_area_master_search
ホットペッパーグルメの大サービスエリアマスタAPIを実行します。
service_area_master_search
ホットペッパーグルメのサービスエリアマスタAPIを実行します。
credit_card_master_search
ホットペッパーグルメのクレジットカードマスタAPIを実行します。
リソース
dinner_budget_master
ホットペッパーグルメの検索用ディナー予算マスタを取得します。
large_service_area_master
ホットペッパーグルメの大サービスエリアマスタを取得します。
service_area_master
ホットペッパーグルメのサービスエリアマスタを取得します。
credit_card_master
ホットペッパーグルメのクレジットカードマスタを取得します。
ライセンス
hotpepper-gourmet-mcp-server はMITライセンスのもとで開発・配布されています。
免責事項
作者ならびにコントリビューターは当アプリケーションの不具合、当アプリケーションを使用すること、当アプリケーションを使用できなかったことによって発生した損害、
もしくは利用者と株式会社リクルート間で発生したトラブルについて、一切責任を負いません。
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.