VoyageHacks

VoyageHacks MCP サーバー

VoyageHacks.comの公式Model Context Protocolサーバーです。VoyageHacksは、フライト、航空会社のレビュー、ホテル、旅行先、レンタカー、鉄道、空港送迎、eSIM、旅行用VPN、旅行用クレジットカード、旅行用品を扱う旅行メディアで、10言語それぞれで約680本のファクトチェック済みガイドを公開しています。

ライブエンドポイント： https://voyagehacks.com/mcp バージョン： 2.3.0 ドキュメント： https://voyagehacks.com/en/mcp-server/

ステートレスなStreamable HTTPトランスポート（POSTによるJSON-RPC 2.0、単一のJSONレスポンス、SSEなし、セッションなし）で、認証は不要です。どのMCPクライアントでも接続後すぐにツールを呼び出せます。GETは仕様上405を返します。Streamable HTTP仕様ではこの場合にSSEストリームが求められますが、このサーバーはSSEストリームを提供しません。

公式MCP Registryにcom.voyagehacks/travelとして登録されています。

接続

Claude Code

claude mcp add --transport http voyagehacks https://voyagehacks.com/mcp

Claude.ai / Claude Desktop： 設定、コネクター、カスタムコネクターを追加、https://voyagehacks.com/mcp、認証は「認証なし」。

ChatGPT： 設定、コネクター、https://voyagehacks.com/mcpを追加、認証なし。

Perplexity（Pro、Max、Enterprise）：設定、コネクター、カスタムコネクター、リモート、https://voyagehacks.com/mcp、認証は「なし」。

Gemini Enterprise： HTTPSエンドポイントを指定し、「認証なし」でカスタムMCPサーバーのデータストアを作成します。トランスポートはStreamableHTTPで、Gemini Enterpriseが必要とする方式です。

MCP Inspector

npx @modelcontextprotocol/inspector

ツール

12個すべて読み取り専用で、readOnlyHint: true、destructiveHint: falseと注釈されており、レスポンス以外に副作用はありません。それぞれにoutputSchemaが宣言され、読みやすいテキストとともにstructuredContentを返します。

ツール	機能
search_articles	1つの言語のガイドを全文検索します。セクションで絞り込むこともできます
get_article	1ページをMarkdownで取得し、ページ自体から読み取ったタイトル、言語、セクション、公開日、最終更新日も返します
search_travel_gear	約50本の公開済み購入ガイドから選んだ約320製品を収録する、VoyageHacksの旅行用品カタログを検索します
recommend_travel_gear	旅行の説明をもとに、カテゴリごとに1製品を選んだ持ち物セットを作成します。構造化されたヒントも指定できます
get_flight_links	ルートと日程に応じたフライト検索リンクを返します
get_hotel_links	都市、日程、宿泊人数、部屋数に応じたホテル検索リンクを返します
get_car_rental_links	レンタカーとスクーターの比較リンクを返します
get_airport_transfer_links	空港タクシーと事前予約可能な送迎サービスのリンクを返します
get_esim_links	旅行先のeSIMストアへのリンクを返します
get_travel_vpn_links	旅行用VPNのリンクを返します
get_credit_card_links	American Express GermanyとRevolutの公式ページ、および確認済みのドイツの手数料情報を返します（紹介リンクなし）
get_booking_links	1回の呼び出しで、1つの旅行に関する複数カテゴリのリンクを返します。includeで絞り込めます
find_destination	月、旅行の種類、予算、同行者に応じて3つの旅行先を提案し、ガイド、日付入りのホテル・フライトリンク、持ち物のおすすめを返します。月または旅行の種類が未指定の場合は、確認事項を返します

get_hotel_linksは、Expedia、Vrbo、Agodaでの同じ条件の検索結果も返します（Stay22）。 旅行用品は、レビューを掲載しているVoyageHacksのガイド内の製品ページ（productUrl、<guide>#p-<asin>）にリンクします。Amazonへの直接リンクは使用しません。Amazonのポリシーでは、タグ付きリンクはパブリッシャー自身のサイトでのみ許可されているためです。

チャット内の旅行先検索ツール（MCP Apps）

find_destinationはMCP Appsのビューui://voyagehacks/trip-finder.html（functions/_mcp-app.js）を宣言します。MCP Appsを表示するホスト（Claude、ChatGPT、VS Codeなど）では、3つの旅行先カードと、ホスト経由でツールを再実行するクイズが表示されます。ホストのライトテーマまたはダークテーマに対応し、リンクはui/open-linkで開きます。それ以外のクライアントには同じ内容がテキストで返されます。

プロンプト

MCP プロンプトをスラッシュコマンドとして表示するクライアントが一覧に表示する where_to_go、plan_trip、pack_for_trip。

各旅行分野のツールは、リクエストされた言語で該当するVoyageHacksガイドを最大4件返すため、エージェントはリンクに加えて記事全文も引用できます。

言語： en、de、fr、es、it、pl、cs、ja、nl、pt、zh。 各ツールには lang パラメーターがあり、デフォルトは en です。各言語のガイドはそれぞれ独立して執筆されており、機械翻訳ではありません。

プロファイル

プロファイル	エンドポイント	ツール
full（デフォルト）	https://voyagehacks.com/mcp	13
research	https://voyagehacks.com/mcp?profile=research	11
guides	https://voyagehacks.com/mcp?profile=guides	5

researchプロファイルでは、サブスクリプション登録ページと金融商品の申し込みページにリンクする get_travel_vpn_links および get_credit_card_links を除外しています。サブスクリプションや購入を開始するページへのリンクを制限するガイドラインを設けているアプリディレクトリ向けのプロファイルです。

guidesプロファイルでは、さらにすべての予約ツールを除外し、search_articles、get_article、search_travel_gear、recommend_travel_gear、find_destination のみを提供します。このプロファイルでは、予約リンクなしでおすすめ、ガイド、荷造りのおすすめを返します。商品は、Amazonで旅行用品を販売するVoyageHacksのガイドにリンクするため、実物商品のみの商取引を許可するディレクトリの要件を満たします。また、実際に備える5つのツールについて説明した独自の initialize 指示を提供します。13個すべてのツールについて説明するものではありません。

各プロファイルには2通りの方法でアクセスできます。/mcp?profile=guides と /mcp/guides は同じハンドラーです。OpenAIのプラグイン申請ポータルでは、MCP Server URL欄にクエリ文字列を指定できないため、パス形式を用意しています。

どちらの形式でも、認識できないプロファイルは完全なツールセットにフォールバックするため、入力ミスによって意図せずツール数が減ることはありません。

このサーバーが行わないこと

このサーバーは、公開済みの編集コンテンツと検索リンクを返します。リアルタイムの運賃や客室料金、空き状況の確認、星評価、レビュー件数は提供せず、予約や支払いもできません。

旅行用品カタログはVoyageHacks独自の編集者による選定品であり、Amazon全体を検索したものではありません。このカタログには価格、評価、レビュー件数、在庫情報は一切含まれません。このアカウントではAmazon Product Advertising APIが有効になっていないため、これらの値を掲載すれば捏造になってしまいます。ツールがこれらのフィールドを返すことはありません。

制限

IPアドレスごとに毎分約90件、リクエスト本文は256 KB、JSON-RPCバッチは25メッセージ、記事は60,000文字で切り捨てられます。レート制限を超えると、サーバーは Retry-After を付けてHTTP 429を返します。SECURITY.mdを参照してください。

エージェント向けMarkdown

このサーバーだけでなく、サイト全体がエージェントから読み取れるようになっています。

• get_article は任意のページをMarkdownで返します。
• voyagehacks.comの任意のページで Accept: text/markdown ヘッダーを指定すると、Markdownが直接返されます（エッジミドルウェアによる対応で、ブラウザーには影響しません）。
• ディスカバリーファイル： /.well-known/mcp/server-card.json、 /llms.txt、 /.well-known/agent-skills/index.json、 /.well-known/api-catalog、 /auth.md。

透明性

VoyageHacks はアフィリエイト収益で運営されるパブリッシャーです。これらのツールが返す予約やショッピングのリンクの一部は、アフィリエイトリンクです（CJ Affiliate を通じた Booking.com およびその他の広告主、Travelpayouts、Stay22）。ツールの出力に Amazon や紹介リンクは含まれません。VoyageHacks は、ユーザーに追加費用が発生することなく、条件を満たす予約や購入からコミッションを得る場合があります。

商用ツールはすべて description にこの旨を記載し、商用のレスポンスではすべて、テキストコンテンツと structuredContent.disclosure の両方でこれを繰り返すため、アシスタントはエンドユーザーに開示できます。エージェントはこれらの文字列に基づいてルーティングを行い、「affiliate」という単語を含めるとツールの選択が測定可能なほど抑制されるため、この単語はツールの name と title の値には含めていません。開示義務が実際に適用されるのは description とレスポンスであるため、そこに記載しています。

記事コンテンツは無料で閲覧でき、ペイウォールも認証もありません。

セルフホスト

これは Cloudflare Pages Function（functions/mcp.js）です。独自のインスタンスを実行するには：

1. functions/ ディレクトリを Cloudflare Pages プロジェクトにデプロイします。
2. サーバーは、フロントに配置したサイトからコンテンツをライブで読み込みます。このサイトは、/<lang>/index.json（検索インデックス）と /<lang>/gear.json（ギアカタログ）を出力する Hugo ビルドです。SITE 定数をデプロイ先に設定してください。
3. mcp.js の先頭付近にあるアフィリエイト定数（Travelpayouts マーカー、CJ ID、Stay22 aid）を、独自のプログラム ID に置き換えます。find_destination は、/<lang>/trip-finder/ のトリップファインダーデータブロックと、assets/js/trip-match.mjs の共通マッチングルールも読み込みます。

このリポジトリは、本番環境の Function をミラーしています。意図的な違いは htmlToMarkdown のインポートのみです。本番環境ではサイトの _middleware.js から htmlToMarkdown をインポートしますが、このミラーでは独自の html-to-markdown.js からインポートします。フォークする場合は、アフィリエイト定数を独自のサイト設定と同期させてください。

プライバシー、利用規約、サポート

• プライバシーポリシー：https://voyagehacks.com/en/privacy/
• 利用規約：https://voyagehacks.com/en/terms/
• セキュリティポリシー：SECURITY.md
• サポートおよびセキュリティに関する報告：[email protected]

ライセンス

MIT