io.github.chrischall由 GitHub 账号 chrischall 发布v2.2.0更新于 Nov 7, 2026
GetYourGuide tours & activities for Claude — search, details, options, and reviews
GetYourGuide 只读 MCP 服务器：让助手通过合作伙伴 API 搜索旅游与活动，查看选项、可订日期和评价。
Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。
参照 仓库 中的启动说明。
MCP server for GetYourGuide — search tours and activities, read tour details, bookable options, and reviews via the GetYourGuide Partner API.
🤖 This project was developed and is maintained by AI (Claude Code). Use at your own discretion.
All tools are read-only — this server registers no write tools.
view — response shapeEvery data tool takes view: "compact" | "full", and compact is
the default. An efficiency that has to be asked for is one that usually is not,
so it is not opt-in — the old compact: true flag on gyg_search_tours is gone.
compact — on the three tour LISTINGS it returns the documented slim
projection (tour_id, title, abstract, url, price, overall_rating,
number_of_ratings, durations, categories, locations), flattened to
{ _metadata, tours }. On gyg_get_tour — one record, no listing envelope to
project — and on every other tool (options, availability, reviews,
categories, location) — it instead strips image URLs and keeps everything else.full — GetYourGuide's whole validated record, untouched.Reach for full when you need a field the projection does not carry (picture
variants, coordinates, marketing copy). Every response is minified JSON either
way: formatting whitespace is dropped, whitespace inside a value is not.
You need a GetYourGuide Partner API key — join the (free) partner program
at partner.getyourguide.com and copy the
API key from your dashboard. The key is sent as the X-ACCESS-TOKEN header on
every request.
The server also boots with no key set (so hosts can probe tools/list at
install time); the first tool call then returns an actionable error telling
you which env var to set.
For local development, put them in a .env next to the server (gitignored;
see .env.example).
429/503 honoring Retry-After
(capped at 10s). If it still fails, the error tells you to back off.GYG_REQUEST_TIMEOUT_MS, or never reaches the API (DNS, refused, reset),
comes back as a tool error naming the request path, with a hint to raise
the timeout or check GYG_BASE_URL and your network. Cancelling a call is
not wrapped — it stays a cancellation.currency: "" or
language: "") is dropped rather than sent, so the env default / USD /
en fallback applies instead of the API rejecting a blank value.401/403 names both possible causes — a wrong key, or
a key whose partner tier doesn't cover that endpoint.docs/GETYOURGUIDE-API.md — routes and request shapes
are live-verified against the API and its official OpenAPI spec; real 200
bodies still need pinning from a keyed capture.extraParams: gyg_search_tours and gyg_get_tour_options accept
extraParams to pass raw query params the schema doesn't model. A key that
collides with one of the tool's own arguments (limit, offset,
currency, cnt_language, q, …) is ignored — the typed argument, or
its default, always wins. (Before 2.1.6 extraParams overrode them.)Releases are automated with release-please; don't hand-bump versions. PR
titles must be conventional commits (feat:, fix:, …) because the repo
squash-merges.
MIT
来源：README.md，提交 1635bc6
Search GetYourGuide tours and activities. Filter by free text (or "iata:<code>" for airports), location ID, category ID, and date range; sort by popularity, price, or rating. Returns slim summaries by default; pass view:"full" for the whole records.
qviewlimitdateTooffsetcurrencydateFromlanguagesortFieldcategoryIdlocationIdextraParams另有 1 个Get the full GetYourGuide record for one tour/activity by its numeric ID. Image URLs are stripped by default; pass view:"full" to keep them.
viewtourId必填currencylanguageList the bookable options of a tour (ticket types, times, languages offered), optionally within a date range. Image URLs are stripped by default; pass view:"full" to keep them.
viewlimitdateTotourId必填currencydateFromlanguageextraParamsGet booking availability for a tour: bookable participant categories, addons, and the list of available dates (with participant ranges). Lighter than gyg_get_tour_options when you only need "when can I go". Image URLs are stripped by default; pass view:"full" to keep them.
viewtourId必填languageList customer reviews for a tour (rating outline plus individual review items). Image URLs are stripped by default; pass view:"full" to keep them.
viewlimitoffsettourId必填currencylanguagesortFieldsortDirectionList GetYourGuide activity categories (use the IDs to filter tour searches). Image URLs are stripped by default; pass view:"full" to keep them.
viewlimitoffsetlanguageList tours in one GetYourGuide category.
viewlimitoffsetcurrencylanguagecategoryId必填Get details for a GetYourGuide location (city, POI, or region) by its numeric ID. Image URLs are stripped by default; pass view:"full" to keep them.
viewlanguagelocationId必填List tours available at one GetYourGuide location (city, POI, or region).
viewlimitoffsetcurrencylanguagelocationId必填Verify credentials and upstream reachability
Resolves the credential the way real tools do, then makes one authenticated request to api.getyourguide.com. Reports which source supplied the credential, whether api.getyourguide.com accepted it, the round-trip time, and a plain-English hint distinguishing 'no credential' from 'credential rejected' from 'a api.getyourguide.com-side problem'. Read-only; never returns the credential itself. Call this when a real tool fails and you want to know which hop broke.
无需输入参数。
已满足适用检查项的 90%
该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。
请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。
{ "mcpServers": { "getyourguide": { "command": "npx", "args": ["-y", "getyourguide-mcp"], "env": { "GYG_API_KEY": "your-partner-api-key" } } }}npm installnpm run build # tsc + esbuild bundle → dist/npm test # tsc typecheck + vitest (no network — everything mocked)npm run test:coverage # tsc typecheck + the CI gate: 100% lines/branches/functions/statements