app.gingerguide由 gingerguide.app 發布官方發布者v2.0.0更新於 Nov 2, 2026
Read-only European city sights: search, nearby, walking routes and itineraries in 6 languages.
唯讀的 Gingerguide 歐洲城市景點目錄：可用六種語言搜尋景點、查看城市指南、比較城市，並規劃步行路線與多日行程。
Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。
把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。
閱讀 https://sourceweft.com/mcp/app.gingerguide%2Fcatalog/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。把它新增到你客戶端的 mcpServers 設定中。
{
"mcpServers": {
"gingerguide-european-city-walking-tours": {
"type": "http",
"url": "https://gingerguide.app/mcp"
}
}
}Gingerguide is a self-guided audio walking tour app for iPhone and Android. It covers 275 European cities and 4,500+ narrated sights in 46 countries. Each sight has a researched 2 to 3 minute story, read by a lifelike AI voice, in English, Spanish, French, German, Turkish and Chinese. Cities work fully offline.
This repository lets AI assistants and agents use the Gingerguide catalog. It contains:
https://gingerguide.app/mcp. Its 14 tools find sights by interest, historical period or location, recommend sights and cities, compare cities, find day trips, give practical visit facts, and plan walking tours and multi-day itineraries, in six languages.SKILL.md format) for audio tour lookup and one-day city walks.The server is read-only. It needs no API key and no sign-in. An optional free API key raises the daily limit (see Optional free API key).
The server works without a key. Without a key, it allows 1,000 tool calls per IP address per UTC day. Hosted assistants such as Claude and ChatGPT call from a few shared IP addresses, so their requests get 50,000 per IP address per day. A free key raises the limit to 20,000 tool calls per key per day and shows your usage. It is useful when your agent runs on a shared cloud (Vercel, AWS, Cloudflare). Only tools/call counts. There is no sign-up and no email.
You can also send the key as X-API-Key. An unknown or revoked key gets HTTP 401. Remove the header to continue without a key. Tool-call responses carry RateLimit and X-RateLimit-Remaining headers. Details: https://gingerguide.app/developers/#api-key.
Every tool is read-only (readOnlyHint: true) and accepts language: en, es, fr, de, tr or zh.
Filter values. Interests: history, architecture, art, museums, religious_sites, archaeology, nature, views, food, local_life, shopping, relaxing, royalty, military, music, literature, science, performing_arts, memorials. Periods: 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. Style: must_see, balanced, hidden_gems. Pace: relaxed, normal, brisk.
Limits of the data. Interests, periods and indoor or outdoor are derived from each sight's category and description. Walking times are estimates (straight-line distance x 1.3 at the chosen pace). Day-trip and comparison distances are straight-line and come without travel times. With weekday, the planners leave out sights that are closed that day or temporarily closed, in researched cities. Opening hours and ticket prices are not included. Bad input returns an error that names the allowed values.
Open Settings → Connectors → Add custom connector. Set the name to Gingerguide and the URL to https://gingerguide.app/mcp.
For older Claude Desktop builds that only read claude_desktop_config.json, use the bridge config in examples/claude_desktop_config.json.
Add this to ~/.cursor/mcp.json (or .cursor/mcp.json in a project). File: examples/cursor-mcp.json.
Add this to .vscode/mcp.json. File: examples/vscode-mcp.json.
In a workspace or plan that allows custom connectors (developer mode), add a new connector with the URL https://gingerguide.app/mcp and no authentication.
Any MCP client that supports remote Streamable HTTP servers can connect to https://gingerguide.app/mcp. See examples/curl.md for raw JSON-RPC calls.
The skills/ folder has two skills in the SKILL.md format. Claude, Claude Code and other agents that read this format can load them.
The same skills are also served from the website at https://gingerguide.app/.well-known/agent-skills/index.json.
The cli/ folder has the source of the official command-line client. It is on npm as gingerguide.
The files in this repository (docs, configs, skills) are under the MIT License. The catalog data that the server and the API return belongs to Gingerguide. See the terms.
Questions or problems: open an issue, or write to [email protected].
來源：README.md，提交 82af0a8
Catalog overview
Coverage of the Gingerguide catalog: number of cities, sights and countries, supported languages, and the exact values accepted by the category, interests and periods filters of the other tools. Call it first when unsure whether a city or filter value is supported.
無需輸入參數。
Search cities
Find covered European cities by name (in any of the six languages), country or region. Returns the city id needed by the other tools, sight count, summary and web guide URL. Omit query to list all cities.
limitquerycountrylanguageList countries
List covered countries with the ids of their cities.
無需輸入參數。
Recommend destinations
Suggest covered European cities that fit a traveler's interests or favourite historical periods, e.g. "best cities for Byzantine history" or "a city break for art and food in Spain". Ranks cities by how many of their sights match, and says why.
limitcountryperiodsintereststrip_daysCompare cities
Compare two to four covered cities side by side, e.g. "Porto or Lisbon?" or "Seville vs Granada for Moorish history". Gives each city's sight count, days needed, strongest interests and historical periods, share of indoor sights and headline sights, says which city is stronger for each interest or period, and the distance between them. Based on the sight catalog only: not prices, weather, nightlife or beaches.
periodscity_ids必填languageintereststrip_daysFind day trips
Day trips from a base city to other covered cities and towns nearby, e.g. "day trips from Florence" or "a day trip from Munich for castles". Ranks destinations by distance, fit with the traveler's interests and periods, and fame, and lists what to see there in one day. Distances are straight-line; travel times are not included because trains, mountains and ferries change them a lot. Only covered cities are listed.
limitcity_id必填periodslanguageinterestshours_on_sitemax_distance_kmGet city guide
One city's guide: overview, headline sights, lesser-known sights, and every sight with category, coordinates, visit minutes and a one-line description. Set detail to "full" to add the long description of every sight (large response).
detailcity_id必填languageSearch attractions
Search individual sights across all cities or within one city, by free text, category, interests, historical period, indoor/outdoor, visit length, free entry or distance from a point. Example: five Byzantine sights in Istanbul, Gothic churches in Spain, or free things to do in Rome. Returns name, description, coordinates, visit minutes and page URL for each match.
sortlimitquerycity_idcountryperiodssettinglanguagenear_latnear_lngfree_onlyinterests另有 3 個Get attraction details
Full details for one sight: long description, a notable fact, photo, coordinates, map links, visit minutes, and the nearest other sights with walking minutes. Use the attraction id from search_attractions or get_city_guide.
languageattraction_id必填Get visit info
Practical facts for visiting one city: best months and crowd seasons, climate, annual events that change a visit, how to get from the airport, main station or cruise port to the centre (typical minutes), city passes, which sights are free, which need booking ahead, weekly closing days and dress codes. Every fact has a source and a check date. No prices or opening hours. Researched for some cities only; the answer says when a city is not covered yet.
topicscity_id必填languageFind nearby attractions
Sights closest to a latitude/longitude (for example the traveler's hotel or current position), sorted by walking time, optionally filtered by interests or category. If nothing is within the radius, returns the nearest covered city.
lat必填lng必填pacelimitlanguageinterestsradius_kmcategoriesRecommend attractions
Personalized picks in one city for a traveler's interests, favourite periods, preference for headline sights or hidden gems, indoor or outdoor, and time available. Each pick says why it was chosen. Use plan_walking_tour instead when the traveler wants an ordered route.
limitstylecity_id必填periodssettinglanguageinterestsexclude_idsavailable_minutesPlan walking tour
Build an ordered self-guided walking route in one city that fits a time budget, e.g. "a two-hour historical walk in Rome". Picks sights by interests, periods and style, orders them to keep walking short, and returns each stop with walking minutes, suggested time on site, clock times and a Google Maps walking link.
pacestylecity_id必填periodssettingweekdaylanguageinterestsstart_latstart_lngstart_timeexclude_ids另有 3 個Plan trip itinerary
Multi-day plan for one city: each day covers one or two walkable areas (with a public-transport hop between them), ordered as walking routes, plus sights that did not fit. Example: "three days in Vienna for art and music lovers".
dayspacestylecity_id必填periodslanguageinterestsstart_timehours_per_daystart_weekday已滿足適用檢查項的 100%
該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。
# 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 itcurl -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 revokecurl -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_...'claude mcp add --transport http gingerguide https://gingerguide.app/mcp{ "mcpServers": { "gingerguide": { "url": "https://gingerguide.app/mcp" } }}{ "servers": { "gingerguide": { "type": "http", "url": "https://gingerguide.app/mcp" } }}npx gingerguide citiesnpx gingerguide city romenpx gingerguide countriesnpx gingerguide health