关键词

韩国旅游旅游信息地区代码旅游景点旅行指南

使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器，旨在为大型语言模型 (LLM) 应用提供韩国旅游信息查询能力。它通过工具的形式，封装了韩国旅游发展局提供的公开API，使得 LLM 能够便捷地获取韩国的地区代码、旅游景点信息、以及景点详情。

主要功能点

  • 地区代码查询 (get_area_code)：
    • 查询韩国行政区域代码，可以获取광역시/도 (广域市/道) 级别或更细粒度的地区列表。
  • 旅游信息搜索 (search_tour_info)：
    • 根据地区、旅游类型（如景点、文化设施、节庆活动等）、关键词或地理位置搜索韩国的旅游信息。支持多种搜索方式，方便用户根据不同条件查找信息。
  • 旅游内容详情查询 (get_detail_common)：
    • 获取特定旅游内容的详细信息，例如景点介绍、地址、联系方式、主页、概要等。通过内容ID即可查询，为用户提供更全面的旅游信息。

安装步骤

  1. 使用 Smithery CLI 安装 (推荐)： 如果您的 LLM 客户端支持 Smithery，可以使用以下命令快速安装此 MCP 服务器：

    npx -y @smithery/cli install @pjookim/mcp-visit-korea --client claude

    按照提示完成安装即可。

  2. 手动部署 (高级用户)： 如果您需要自定义部署或您的客户端不支持 Smithery，可以手动下载仓库代码，并确保已安装 Node.js 环境。

    • 克隆或下载此 GitHub 仓库的代码。
    • 进入项目根目录，安装依赖：'npm install'
    • 设置环境变量 'TOUR_API_KEY' 为您在韩国旅游数据开放平台申请的API密钥。
    • 启动服务器：'npm start' (或者 'node index.js')

服务器配置

对于 MCP 客户端，您需要配置连接到此 MCP 服务器的必要信息。以下是一个 JSON 格式的配置示例，您需要将其添加到您的 MCP 客户端配置中。

{
  "serverName": "ktour-api",  // 服务器名称，可以自定义
  "command": "node",         // 启动服务器的命令，这里使用 node.js 运行
  "args": ["index.js"],      // 启动命令的参数，指向服务器入口文件
  "env": {
    "TOUR_API_KEY": "YOUR_TOUR_API_KEY" // 韩国旅游API密钥，请替换为您的实际密钥
  }
}

请注意：

  • 'YOUR_TOUR_API_KEY' 处需要替换为您在韩国旅游数据开放平台申请的 API 密钥。这是访问韩国旅游 API 的凭证，务必正确配置。
  • 'command' 和 'args' 配置假设您在项目根目录下运行服务器。如果您的部署环境不同，请根据实际情况调整。

基本使用方法

成功安装并配置 MCP 服务器后，您的 LLM 客户端应该能够检测到名为 'ktour-api' 的服务器及其提供的工具。您可以通过自然语言指令，指示 LLM 调用这些工具来查询韩国旅游信息。

例如，您可以向 LLM 提出类似如下的指令：

  • “我想查询首尔的旅游景点”
  • “帮我找一下釜山的美食店”
  • “请告诉我景福宫的详细信息”
  • “有没有关于济州岛的庆典活动？”

LLM 客户端会解析您的指令，并自动调用 'ktour-api' 服务器提供的工具，获取相关信息并返回给您。具体的指令格式和使用方式，请参考您使用的 LLM 客户端的文档。

信息

分类

网页与API

访问项目