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 数据，以确保信息的最新性。
• 在生产环境中使用时，请考虑性能优化和错误处理。