Jinko MCP

🚀 ホテル予約MCPサーバー

このサーバーは、200万軒以上のホテルの検索と予約機能を提供する最初のMCPサーバーです。簡単に統合し、すぐにホテル予約の販売を開始できます。

🚀 クイックスタート

このMCPサーバーは、標準入出力トランスポートを使用しています。これは、このトランスポートタイプをサポートするMCPクライアントと直接使用できることを意味します。

✨ 主な機能

1. 場所検索：ユーザーの場所クエリを座標付きの標準化された場所情報に変換します。
2. ホテル検索：場所の座標と予約要件に基づいて、利用可能なホテルを検索します。
3. ホテル詳細取得：特定のホテルに関する包括的な詳細情報を取得します。
4. ホテル予約：見積もりを作成し、支払いリンクを返すことで、ホテルを予約します。
5. 施設情報取得：検索をフィルタリングするために、異なる言語でホテルの施設情報を取得します。

📦 インストール

現在は、MCPをローカルにインストールできます。リモートサポートも間もなく追加されます。本番環境へのアクセスを希望し、販売に対するコミッションを獲得したい開発者は、ウェブサイト https://www.jinko.so/ を通じてお問い合わせください。

{
  "mcpServers": {
    "jinko-travel": {
      "command": "npx",
      "args": [
        "jinko-mcp-dev@latest"
      ]
    }
  }
}

💻 使用例

基本的な使用法

パッケージのグローバルインストール

npm install -g jinko-mcp-dev

npxを使用した直接実行

npx jinko-mcp-dev

高度な使用法

npmを使用したサーバーの起動

npm run start

npxを使用したサーバーの起動（公開後）

npx jinko-mcp-dev

📚 ドキュメント

ツールの説明

1. find - place

ユーザーの場所クエリを座標付きの標準化された場所情報に変換します。

パラメーター:

• query: 場所検索のためのユーザー入力（例: 'New York', 'Paris', 'Tokyo'）
• language (オプション): 場所検索の言語、デフォルト: 'en'

このツールは、ホテル検索に緯度と経度が必要で、テキスト記述しか持っていない場合に不可欠です。都市名、ホテル名、ランドマーク、またはその他の場所識別子を受け取り、一致する場所の詳細と正確な座標のリストを返します。

2. search - hotels

場所の座標と予約要件に基づいて、利用可能なホテルを検索します。

パラメーター:

• latitude: 場所の緯度
• longitude: 場所の経度
• check_in_date: チェックイン日（YYYY - MM - DD）、デフォルト: '2025 - 06 - 25'
• check_out_date: チェックアウト日（YYYY - MM - DD）、デフォルト: '2025 - 06 - 26'
• adults: 大人の人数、デフォルト: 2
• children: 子供の人数、デフォルト: 0
• facilities (オプション): ホテルをフィルタリングするための施設ID、IDは get - facilities ツールで取得できます。

このツールは、ホテルの名前、住所、星評価、価格帯、および利用可能な部屋タイプを含む主要な詳細情報のページングされたリストを返します。各ホテルには、アメニティの概要情報と利用可能な料金が含まれています。結果は、1リクエストあたり50件のホテルに制限されています。

3. load - more - hotels

前の検索のセッションIDを使用して、追加のホテル検索結果を取得します。

パラメーター:

• session_id: 前の search - hotels または load - more - hotels レスポンスのセッションID

このツールは、前の search - hotels リクエストからのページングを続け、元の検索と同じ形式と詳細で次のバッチのホテルを返します。

4. get - hotel - details

特定のホテルのIDを使用して、そのホテルに関する包括的な詳細情報を取得します。

パラメーター:

• session_id: 前の検索のセッションID
• hotel_id: 詳細情報を取得するホテルのID

このツールは、検索結果で利用可能な情報よりも詳細な情報を提供します。完全な説明、すべての利用可能な部屋タイプ、詳細な料金情報、キャンセルポリシー、および完全なアメニティリストが含まれています。

5. book - hotel

特定のホテルと料金オプションの予約プロセスを開始します。

パラメーター:

• session_id: 前の検索のセッションID
• hotel_id: 予約するホテルのID
• rate_id: ユーザーが選択した特定の料金オプションのID

このツールは、指定されたホテルと部屋の予約見積もりを作成し、ユーザーが予約を完了するための支払いリンクを返します。

6. get - facilities

指定された言語でホテルの施設リストを取得します。

パラメーター:

• language: 施設名の言語コード（en, es, it, he, ar, de）、デフォルト: 'en'

ユーザーが特定のホテルアメニティまたは要件を指定した場合、search - hotels を使用する前にこのツールを呼び出す必要があります。このツールは、search - hotels ツールの facilities パラメーターでホテルを適切にフィルタリングするために使用する必要がある施設IDを返します。

リソース

標準サーバーは、複数の言語でホテル施設データをリソースとして提供します。

• 英語 (en)
• スペイン語 (es)
• イタリア語 (it)
• ヘブライ語 (he)
• アラビア語 (ar)
• ドイツ語 (de)

これらのリソースは、hotel://facilities/{language} URIパターンを使用してアクセスできます。ここで、{language} はサポートされている言語コードの1つです。

施設データ

サーバーには、ホテルのアメニティに関する情報を提供するための組み込み施設データが含まれています。このデータは、ユーザーが要求した特定のアメニティに基づいてホテル検索をフィルタリングするために使用されます。

各施設には次の情報が含まれています。

• facility_id: 施設の一意の識別子
• facility: 施設の英語名
• sort: 表示のための並び順
• translation: 異なる言語での翻訳の配列

get - facilities ツールを使用すると、利用可能な施設がレスポンスの一部として返され、LLMが search - hotels ツールでホテル検索をフィルタリングする際に適切な施設IDを使用できるようになります。

ワークフロー例

標準サーバーを使用する典型的なワークフローは次のとおりです。

1. find - place を使用して、ユーザーの場所クエリを座標に変換します。
2. get - facilities を使用して、ユーザーが要求したアメニティの施設IDを特定します。
3. search - hotels を座標と施設IDで使用して、一致するホテルを検索します。
4. 最初の50件を超える結果が必要な場合は、load - more - hotels を使用します。
5. get - hotel - details を使用して、特定のホテルに関する包括的な情報を取得します。
6. book - hotel を使用して、予約プロセスを開始し、支払いリンクを生成します。

npmへの公開

このパッケージをnpmに公開するには、次の手順に従ってください。

1. npmアカウントを持っていることを確認し、ログインします。

   npm login
   

2. package.jsonのバージョン番号を更新します。

   npm version patch  # または minor または major
   

3. プロジェクトをビルドします。

   npm run build
   

4. npmに公開します。

   npm publish
   

公開後、ユーザーは「インストール」セクションで説明されているように、npmまたはnpxを使用してパッケージをインストールし、実行できます。

🔧 技術詳細

MCP（Model Context Protocol）は、アプリケーションがLLMにコンテキストを提供する方法を標準化するオープンプロトコルです。AIアプリケーションのUSB - Cポートのようなもので、モデルを外部データソースやツールに接続します。

📄 ライセンス

このリポジトリは、元々 https://github.com/jinkoso/jinko - mcp から派生しています。

• 元の作者: Jinko
• 元のリポジトリはGitHubではもう利用できません。