MCP Korea Tourism Api

🚀 韓國旅遊信息 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: 下載 Korea Tourism 數據

為使 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：根據地區和區域代碼搜索酒店、 guesthouses 等住宿設施。
6. get_detailed_information：使用內容 ID 獲取特定旅遊項目的詳細信息（概述、使用時間、停車等），可根據內容類型進行過濾。
7. get_tourism_images：使用內容 ID 獲取特定旅遊項目的圖像 URL。
8. get_area_codes：獲取區域代碼（城市/省份）及其可選子區域代碼。

⚠️ 重要提示

⚠️ 重要提示

• 確保您擁有有效的 API 密鑰，並瞭解其使用限制和條款。
• 定期更新 Korea Tourism 數據，以確保信息的最新性。
• 在生產環境中使用時，請考慮性能優化和錯誤處理。