MCP Korea Tourism Api

🚀 韓国観光情報MCPサービス統合ガイド

このガイドでは、韓国観光情報MCPサービスのDockerインストール方法、Cursorへの統合方法、提供されるMCPツールの概要、その他注意事項について説明します。

🚀 クイックスタート

📦 インストール

Dockerを使用したMCPサービスのインストール

以下の手順に従って、MCPサービスをDockerでインストールします。

ステップ1: MCPディレクトリの作成

プロジェクトディレクトリ内に mcp-korea-tourism-api という名前の新しいフォルダを作成します。このフォルダには、韓国観光情報に関連するすべてのコードとリソースを配置します。

mkdir -p mcp-korea-tourism-api
cd mcp-korea-tourism-api

ステップ2: 依存関係のダウンロード

MCPサービスが正常に動作するために、必要なPythonパッケージをインストールする必要があります。requirements.txt ファイルを作成し、以下の依存関係を追加します。

uv>=0.13.0
python-dotenv==0.19.0

ステップ3: 依存関係のインストール

pipを使用してこれらのパッケージをインストールします。

pip install -r requirements.txt

ステップ4: 韓国観光データのダウンロード

MCPサービスが韓国観光データにアクセスできるように、韓国観光公社から最新のXMLファイルを取得します。これらのファイルを mcp-korea-tourism-api/data ディレクトリに配置します。

ステップ5: MCPサービスの起動

これでMCPサービスを起動できます。以下のコマンドを実行します。

uv run mcp_tourism.server

Cursorへの統合

CursorでこのMCPサービスを使用するには、以下の手順に従います。

ステップ1: Dockerコンテナの実行確認

上述の手順に従ってDockerコンテナを構築して実行します。mcp-korea-tourism-api イメージが存在し、正常に動作することを確認します。

ステップ2: mcp.json ファイルの検索

このファイルは、CursorのMCPツールを構成するために使用されます。通常、~/.cursor/mcp.json または同様のパスにあります。

ステップ3: MCP構成の追加または更新

mcp.json ファイルに以下のJSONオブジェクトを追加します。このツールのエントリが既にある場合は、その command 属性を更新します。"YOUR_KTO_API_KEY" を実際のAPIキーに置き換えます。

Dockerを使用した構成例:

{
    "mcpServers": {
        "korea-tourism": {
            "command": "docker",
            "args": [
                "run",
                "--rm",
                "-i",
                "-e",
                "KOREA_TOURISM_API_KEY=YOUR_KTO_API_KEY",
                "mcp-korea-tourism-api"
            ]
        }
    }
}

uvを使用した構成例:

{
    "mcpServers": {
        "korea-tourism": {
            "command": "uv",
            "args": [
                "--directory",
                "{LOCAL_PATH}/mcp-korea-tourism-api",
                "run",
                "-m",
                "mcp_tourism.server"
            ],
            "env": {
                "KOREA_TOURISM_API_KEY": "YOUR_KTO_API_KEY"
            }
        }
    }
}

ステップ4: mcp.json ファイルの保存

構成を完了したら、mcp.json ファイルを保存します。

ステップ5: Cursorの再起動またはMCPツールの再読み込み

Cursorは新しいツールを検出し、必要に応じてDockerを使用して起動します。

✨ 主な機能

このサーバーは、AIアシスタントに以下の機能を提供します。

1. search_tourism_by_keyword: キーワード（例:「景福宮」、「ビビンバ」）を使用して観光情報を検索します。コンテンツタイプと地域コードでフィルタリングできます。
2. get_tourism_by_area: 地理的な地域コード（例: ソウル = '1'）に基づいて観光情報を閲覧します。コンテンツタイプと地域コードでフィルタリングできます。
3. find_nearby_attractions: 特定のGPS座標（経度、緯度）に基づいて近くの観光名所を検索します。半径とコンテンツタイプでフィルタリングできます。
4. search_festivals_by_date: 指定された日付範囲（形式: YYYYMMDD）内の祭り情報を検索します。地域コードでフィルタリングできます。
5. find_accommodations: 地域と地域コードに基づいてホテル、ゲストハウスなどの宿泊施設を検索します。
6. get_detailed_information: コンテンツIDを使用して特定の観光プロジェクトの詳細情報（概要、利用時間、駐車場など）を取得します。コンテンツタイプでフィルタリングできます。
7. get_tourism_images: コンテンツIDを使用して特定の観光プロジェクトの画像URLを取得します。
8. get_area_codes: 地域コード（都市/州）とそのオプションのサブ地域コードを取得します。

🔧 その他注意事項

• 有効なAPIキーを持っていること、およびその使用制限と条項を理解していることを確認してください。
• 情報の最新性を確保するために、定期的に韓国観光データを更新してください。
• 本番環境で使用する場合は、パフォーマンスの最適化とエラー処理を考慮してください。