Korea Tourism API MCP Server ✈️
2025.04.11
4
Python旅游信息查询文化活动搜索餐饮住宿推荐节日活动查询位置服务
mcp-korea-tourism-api 是一个基于韩国旅游组织（KTO）官方API的Model Context Protocol（MCP）服务器，旨在为AI助手提供韩国旅游信息的查询能力。通过该服务，用户可以获取包括旅游景点、文化活动、餐饮住宿等在内的丰富旅游信息，支持多语言查询和地理位置搜索。
View on GitHub
Overview
基本能力
产品定位
mcp-korea-tourism-api 是一个专门为AI助手设计的旅游信息查询服务，通过集成韩国旅游组织的官方API，提供全面的韩国旅游信息查询功能。
核心功能
- 全面搜索：通过关键词、区域或位置搜索旅游景点、文化遗址、活动、餐饮、住宿和购物信息。
- 详细信息：获取包括描述、开放时间、门票价格、照片、地址和联系信息在内的详细数据。
- 位置感知：基于GPS坐标发现附近的景点。
- 时间信息：根据日期范围查询节日和活动信息。
- 多语言支持：支持包括英语、日语、简体中文、繁体中文、俄语、西班牙语、德语和法语在内的多种语言。
- 高效与弹性：
- 响应缓存：使用TTL缓存存储结果，减少冗余API调用，提高速度。
- 速率限制：遵守API使用限制，防止错误。
- 自动重试：在网络或服务器临时问题时自动重试请求。
- MCP标准：无缝集成支持Model Context Protocol的AI助手。
适用场景
- 旅游信息查询
- 文化活动搜索
- 餐饮住宿推荐
- 节日活动查询
工具列表
search_tourism_by_keyword：通过关键词搜索旅游信息。get_tourism_by_area：按地理区域代码浏览旅游信息。find_nearby_attractions：发现特定GPS坐标附近的旅游景点。search_festivals_by_date：查找指定日期范围内的节日。find_accommodations：搜索酒店、宾馆等住宿信息。get_detailed_information：获取特定项目的详细信息。get_tourism_images：获取与特定旅游项目相关的图片URL。get_area_codes：检索区域代码（城市/省份）和子区域（区）代码。
常见问题解答
- 如何获取API密钥：需要从韩国旅游组织（KTO）数据门户申请API密钥。
- 多语言支持：需要为每种语言单独申请API。
使用教程
使用依赖
- 需要从KTO数据门户获取API密钥。
安装教程
通过Smithery安装
npx -y @smithery/cli install @harimkang/mcp-korea-tourism-api --client claude
使用uv（推荐本地开发）
- 克隆仓库：
git clone https://github.com/harimkang/mcp-korea-tourism-api.git
cd mcp-korea-tourism-api
- 设置API密钥环境变量：
export KOREA_TOURISM_API_KEY="YOUR_KTO_API_KEY"
- 安装依赖并运行服务器：
uv run -m mcp_tourism.server
使用Docker（推荐隔离环境/部署）
- 克隆仓库：
git clone https://github.com/harimkang/mcp-korea-tourism-api.git
cd mcp-korea-tourism-api
- 构建Docker镜像：
docker build -t mcp-korea-tourism-api .
- 运行Docker容器：
docker run --rm -it -e KOREA_TOURISM_API_KEY="YOUR_KTO_API_KEY" mcp-korea-tourism-api
调试方式
- 确保API密钥正确设置。
- 检查服务器日志以确认服务是否正常运行。