Gingerguide: European city walking tours

Gingerguide MCP サーバーとエージェントスキル

Gingerguide は、iPhone と Android 向けのセルフガイド式音声ウォーキングツアーアプリです。 39 か国、169 都市、3,100 か所以上のナレーション付きスポットを収録しています。各スポットには、調査に基づく2〜3分のストーリーがあり、英語、スペイン語、フランス語、ドイツ語、トルコ語、中国語で、人間らしいAI音声によって読み上げられます。各都市では完全にオフラインで利用できます。

このリポジトリを使うと、AI アシスタントやエージェントから Gingerguide のカタログを利用できます。内容は次のとおりです。

• 公開されている Gingerguide MCP サーバー（https://gingerguide.app/mcp）の接続情報。14個のツールで、興味、歴史的時代、場所からスポットを検索したり、スポットや都市をおすすめしたり、都市を比較したり、日帰り旅行先を探したり、訪問に役立つ実用的な情報を得たり、6言語でウォーキングツアーや複数日程の旅程を計画したりできます。
• 音声ツアーの検索と1日で巡る都市ウォークのための、2つの エージェントスキル（SKILL.md 形式）。
• そのままコピーして使える クライアント設定と curl の例。

サーバーは読み取り専用です。API キーやサインインは必要ありません。任意で無料の API キーを使うと、1日あたりの上限を引き上げられます（任意の無料 API キーを参照）。

MCP エンドポイント	https://gingerguide.app/mcp
トランスポート	Streamable HTTP（ステートレス、JSON レスポンス）
認証	不要（任意で無料の API キーを使用可能）
MCP Registry 名	app.gingerguide/catalog
開発者向けドキュメント	https://gingerguide.app/developers/
OpenAPI（REST）	https://gingerguide.app/api/openapi.json
llms.txt	https://gingerguide.app/llms.txt

任意の無料 API キー

サーバーはキーなしで動作します。キーがない場合、UTC の1日あたり、IP アドレスごとに1,000回のツール呼び出しが可能です。Claude や ChatGPT などのホスト型アシスタントは、少数の共有 IP アドレスから呼び出すため、IP アドレスごとに1日あたり50,000回のリクエストが可能です。無料のキーを使うと、キーごとの1日あたりのツール呼び出し上限が20,000回に増え、使用状況も確認できます。エージェントを共有クラウド（Vercel、AWS、Cloudflare）上で実行する場合に便利です。カウントされるのは tools/call のみです。登録やメールアドレスは不要です。

# Create a key (it is shown once; the server stores only its hash)
curl -sS -X POST https://gingerguide.app/api/keys \
  -H 'content-type: application/json' -d '{"label":"my-agent"}'

# Use it
curl -sS https://gingerguide.app/mcp \
  -H 'authorization: Bearer ggk_...' \
  -H 'content-type: application/json' -H 'accept: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# Usage for the last 30 days, and revoke
curl -sS https://gingerguide.app/api/keys/me -H 'authorization: Bearer ggk_...'
curl -sS -X DELETE https://gingerguide.app/api/keys/me -H 'authorization: Bearer ggk_...'

キーは X-API-Key として送信することもできます。不明または失効したキーの場合、HTTP 401 が返されます。キーなしで続けるには、ヘッダーを削除してください。ツール呼び出しのレスポンスには、RateLimit ヘッダーと X-RateLimit-Remaining ヘッダーが含まれます。詳細：https://gingerguide.app/developers/#api-key。

ツール

すべてのツールは読み取り専用（readOnlyHint: true）で、language に en、es、fr、de、tr、zh のいずれかを指定できます。

検索

ツール	説明	主な引数
search_attractions	フリーテキスト、カテゴリー、興味分野、歴史的時代、屋内または屋外、見学時間、入場無料、地点からの距離を条件に、全都市または特定の都市の観光スポットを検索します。例：イスタンブールのビザンティン時代の観光スポットを5か所。	query、city_id、country、categories、interests、periods、setting、free_only、near_lat、near_lng、radius_km、sort、limit
find_nearby_attractions	緯度と経度を基準に、最も近い観光スポットを徒歩での所要時間とともに返します。半径内に観光スポットがない場合は、対象となっている最寄りの都市を返します。	lat、lng、radius_km、interests、categories、pace
get_attraction	1か所の観光スポットについて、詳細な説明、特筆すべき事実、写真、座標、地図リンク、見学時間、最寄りの他の観光スポットを返します。調査済みの都市では、入場情報、予約情報、週ごとの休業日、服装規定、公式サイトも追加されます。	attraction_id（例：rome-colosseum）
get_visit_info	1都市の実用情報を返します。おすすめの時期と混雑シーズン、空港・主要駅・クルーズ港から中心部への行き方、シティパス、無料の観光スポット、事前予約が必要なもの、週ごとの休業日、服装規定が含まれます。すべての情報に出典と確認日が付いています。調査済みの都市（現時点ではローマ、バルセロナ、ウィーン）のみ対応しており、その他の都市についてはその旨を伝えます。	city_id、topics
search_cities	6言語のいずれかによる都市名、国、地域で都市を検索します。他のツールで必要となる都市 ID を返します。	query、country、limit
get_city_guide	1都市の概要、主要な観光スポット、あまり知られていない観光スポット、およびカテゴリー、座標、見学時間を含むすべての観光スポットを返します。detail: "full"を指定すると、すべての詳細な説明が追加されます。	city_id、detail
list_countries	対象となっている国と、その国の都市 ID を一覧表示します。	なし
get_catalog_overview	対象範囲の合計、言語、およびcategories、interests、periodsの各フィルターで指定できる正確な値を返します。	なし

おすすめ

ツール	説明	主な引数
recommend_attractions	旅行者の興味分野、お気に入りの時代、主要な観光スポットまたは穴場、屋内または屋外、利用可能な時間に合わせて、1都市の観光スポットを選びます。各候補には、選ばれた理由が記載されます。	city_id、interests、periods、style、setting、available_minutes、exclude_ids
recommend_destinations	興味分野や歴史的時代に合わせて都市を順位付けします。たとえば「ビザンティン史を楽しめるおすすめの都市」を提示し、その理由も説明します。	interests、periods、country、trip_days
compare_cities	2〜4都市を並べて比較します。観光スポット、必要な日数、特に充実している興味分野や時代、屋内の観光スポットの割合、主要な観光スポット、都市間の距離が含まれます。各興味分野や時代について、どの都市がより充実しているかを示します。	city_ids、interests、periods、trip_days
find_day_trips	拠点となる都市から日帰りできる対象都市を、距離、興味分野、知名度に基づいて順位付けし、1日で見られるものとともに一覧表示します。飛行機が必要な海上移動は除外し、短いフェリー移動にはその旨を記します。	city_id、max_distance_km、interests、periods、hours_on_site

プラン

ツール	機能	主な引数
plan_walking_tour	所要時間に合わせて、1つの都市内の順序付き徒歩ルートを作成します。各立ち寄り先について、徒歩時間、滞在時間、時刻、Google Maps の徒歩ルートへのリンクを返します。	city_id、duration_minutes、interests、periods、style、pace、start_lat、start_lng または start_attraction_id、start_time、must_include、weekday
plan_trip_itinerary	1つの都市で1～7日間の旅程を計画します。各日は、徒歩で回れる1つまたは2つのエリアを巡り、エリア間は公共交通機関で移動します。	city_id、days、hours_per_day、interests、periods、style、pace、start_time、start_weekday

フィルター値。 興味の対象：history、architecture、art、museums、religious_sites、archaeology、nature、views、food、local_life、shopping、relaxing、royalty、military、music、literature、science、performing_arts、memorials。時代：prehistoric、ancient_greek、etruscan、roman、byzantine、medieval、gothic、moorish_islamic、ottoman、renaissance、baroque、georgian_neoclassical、nineteenth_century、art_nouveau、twentieth_century_modern、world_war_ii、cold_war。スタイル：must_see、balanced、hidden_gems。ペース：relaxed、normal、brisk。

データの制限。 興味の対象、時代、屋内・屋外の区分は、各スポットのカテゴリーと説明に基づいています。徒歩時間は推定値です（直線距離に1.3を掛け、選択したペースを適用）。日帰り旅行と比較の距離は直線距離で、所要時間は含まれません。weekdayを指定すると、調査済みの都市では、その日に休業しているスポットや一時休業中のスポットはプランから除外されます。営業時間とチケット料金は含まれません。入力に誤りがある場合は、使用可能な値を示すエラーが返されます。

クライアントを接続する

Claude Code

claude mcp add --transport http gingerguide https://gingerguide.app/mcp

Claude（デスクトップおよびウェブ）

設定 → コネクター → カスタムコネクターを追加を開きます。名前をGingerguide、URLをhttps://gingerguide.app/mcpに設定します。

claude_desktop_config.jsonのみを読み込む古いClaude Desktopビルドの場合は、examples/claude_desktop_config.jsonのブリッジ設定を使用してください。

Cursor

これを~/.cursor/mcp.json（またはプロジェクト内の.cursor/mcp.json）に追加します。ファイル：examples/cursor-mcp.json。

{
  "mcpServers": {
    "gingerguide": { "url": "https://gingerguide.app/mcp" }
  }
}

VS Code（GitHub Copilot エージェントモード）

これを.vscode/mcp.jsonに追加します。ファイル：examples/vscode-mcp.json。

{
  "servers": {
    "gingerguide": { "type": "http", "url": "https://gingerguide.app/mcp" }
  }
}

ChatGPT

カスタムコネクターが利用可能なワークスペースまたはプラン（開発者モード）で、URLをhttps://gingerguide.app/mcpに設定し、認証なしで新しいコネクターを追加します。

その他のクライアント

リモートStreamable HTTPサーバーに対応するMCPクライアントであれば、https://gingerguide.app/mcpに接続できます。生のJSON-RPC呼び出しについては、examples/curl.mdを参照してください。

プロンプトの例

• 「イスタンブールでビザンチン時代の歴史的スポットを5つ探してください。」
• 「10:00に出発する、ローマの2時間の歴史散策ツアーを計画してください。」
• 「ウィーンの聖シュテファン大聖堂の近くに滞在しています。徒歩10分で行ける場所はありますか？」
• 「芸術と音楽が好きな人向けに、ウィーンで3日間のプランを立ててください。」
• 「ビザンチン時代の歴史を楽しむのに最適なヨーロッパの都市はどこですか？」
• 「フィレンツェからの日帰り旅行には、どんなおすすめがありますか？」
• 「チヴィタヴェッキアのクルーズ港からローマへはどう行けばよいですか？また、何を予約する必要がありますか？」
• 「日曜日にローマで4時間、芸術を楽しむプランを立ててください。」
• 「初めての旅行なら、ポルトとリスボンのどちらがおすすめですか？比較してください。」
• 「雨が降っているので屋内で楽しめる、建築好き向けのパリの穴場を教えてください。」
• 「コロッセオについて、ドイツ語で教えてください。」
• 「セビリアに音声ガイド付きの徒歩ツアーはありますか？」

エージェントスキル

skills/ フォルダーには、SKILL.md 形式のスキルが 2 つあります。Claude、Claude Code およびこの形式を読み込めるその他のエージェントは、これらを読み込めます。

スキル	次のような場合に使用します
find-audio-walking-tour	都市の音声ツアー、ウォーキングツアー、またはセルフガイドの案内を求めている
plan-city-day-with-gingerguide	対応都市での 1 日の旅程またはウォーキングルートを求めている

同じスキルは、ウェブサイト https://gingerguide.app/.well-known/agent-skills/index.json からも提供されています。

REST API（MCP 不要）

エンドポイント	返される内容
GET https://gingerguide.app/api/cities.json	ID、国、スポット数、ガイド URL を含むすべての都市
GET https://gingerguide.app/api/cities/{id}.json	すべてのスポットを含む 1 つの都市
GET https://gingerguide.app/api/openapi.json	OpenAPI の説明

CLI

cli/ フォルダーには、公式コマンドラインクライアントのソースがあります。npm では gingerguide として公開されています。

npx gingerguide cities
npx gingerguide city rome
npx gingerguide countries
npx gingerguide health

エージェント向けのルール

• データで確認できる範囲のみを述べてください。ガイドやスポットを捏造しないでください。
• ナレーションは生き生きとした AI 音声です。人間の声とは呼ばないでください。
• データにある都市ガイドの URL にリンクしてください。例：https://gingerguide.app/en/cities/rome/.

アプリを入手

• iPhone と iPad：App Store
• Android：Google Play
• ウェブガイド：gingerguide.app

ライセンス

このリポジトリ内のファイル（ドキュメント、設定、スキル）は、MIT License のもとで公開されています。サーバーと API が返すカタログデータは Gingerguide に帰属します。利用規約をご覧ください。

質問や問題がある場合は、issue を作成するか、[email protected] までご連絡ください。