Pinpoint Flights

Pinpoint Flights MCP サーバー

Pinpoint Flights のホスト型 MCP サーバーのソースです。 正確な時間帯、直行便と価格のトレードオフ、手荷物、運賃規則、避けたい航空会社、日程と旅行期間の柔軟な指定、近隣の空港、複数の目的地を一度に指定するなど、非常に詳細な絞り込みができるフライト検索です。

自分の言葉でアシスタントにフライトを尋ねてください。アシスタントが絞り込み条件を入力し、必要な情報を質問したうえで、pinpoint.flights で予約できるリンク付きの最適な候補を提示します。

Fla. Seller of Travel Reg. No. ST150266

使い方

このリポジトリから何かを実行する必要はありません。サーバーはホストされており、公式 MCP Registry に flights.pinpoint/pinpoint-flights として掲載されています。

1. https://pinpoint.flights/connect から無料の個人用リンクを取得します。リンクは https://pinpoint.flights/mcp/<key> の形式です。
2. 次のいずれかの方法でアシスタントに追加します。

   • URL として： 個人用リンクをカスタムコネクターとして貼り付けます（Gemini、 Claude、ChatGPT）。

   • ヘッダーとして： https://pinpoint.flights/mcp に接続し、リンクの末尾部分であるキーを Authorization: Bearer <key> として送信します。たとえば、Claude Code では次のようにします。

     claude mcp add --transport http pinpoint-flights https://pinpoint.flights/mcp \
       --header "Authorization: Bearer <key>"
     

キーがなくてもサーバーには接続でき、ツールの一覧が表示されますが、検索するとキーの取得方法が案内されます。各キーには新規検索の日次利用枠があります。過去24時間以内に行った検索を繰り返す場合は無料です。キーの発行と航空券の販売は、Pinpoint Flights が旅行を販売できる地域でのみ行っています。

ツール

読み取り専用として注釈された search_flights が1つあります。引数はすべて検索条件で、いずれも任意です。アシスタントはユーザーが伝えた条件だけを送信し、残りはデフォルト値で補います。

引数グループ	内容
origin, destination	出発地、近隣の空港、代替候補となる複数の目的地
departEarliest … returnLatest, arriveBy, tripLength, blackouts	固定または柔軟な日程、到着期限、滞在期間
outboundDays, returnDays, outboundTimes, returnTimes	必須条件または希望条件として指定する曜日と時刻の範囲
travelers, bags, cabin, fare, budget	旅行者、料金に含める手荷物、座席クラス、運賃規則、価格の上限
route, airlines, exactFlights, stopover, amenities	経由地と乗り継ぎ、優先または回避する航空会社、搭乗したい特定のフライト

日程など、検索結果に影響する情報が不足している場合、検索は実行されません。代わりにツールが質問を返し、アシスタントが先にユーザーへ質問します。

このリポジトリの内容

ファイル
src/lib/mcp/server.ts	MCP プロトコル：initialize、tools/list、tools/call
src/lib/mcp/search.ts	search_flights ツール：スキーマ、説明、検索結果の提示方法
src/lib/mcp/serve.ts、src/app/mcp/	キーを URL に含める場合と含めない場合の2つの HTTP アドレス
src/lib/mcp/keys.ts	コネクターキーの作成と検証方法
src/lib/mcp/server.json	MCP Registry マニフェスト
tests/mcp.test.ts	テスト

これは Pinpoint Flights のコードベースにあるサーバーファイルのコピーです。ホスト型サーバーの背後にあるコードを読めるように、ここに置いています。単体で動作するプロジェクトではなく、単独ではビルドできません。検索機能そのもの（プランナー、運賃プロバイダー、サイトのその他の部分）はこのリポジトリに含まれていません。

質問と問題

こちらで issue を作成するか、[email protected] にお問い合わせください。