关键词

Kakao地图地点推荐韩国韩语位置服务

项目简介

本项目是一个实现了 Model Context Protocol (MCP) 协议的服务器，专注于为大型语言模型（LLM）应用提供韩国地点推荐功能。它利用 Kakao Map API，能够根据用户输入的韩语查询，推荐韩国境内的各类场所，如餐厅、咖啡馆、景点等。

主要功能点

  • 地点推荐工具: 提供名为 'kakao_map_place_recommender' 的工具，允许LLM客户端通过发送韩语查询请求，获取相关的地点推荐信息。
  • 韩国地点搜索: 专注于韩国地点搜索，使用户可以方便地查找韩国的各类场所信息。
  • 基于 Kakao Map API: 利用强大的 Kakao Map API 提供准确的地点数据。
  • 韩语查询优化: 特别针对韩语查询进行了优化，能够更好地理解和处理韩语的地点搜索请求。
  • Markdown 格式输出: 工具返回的结果以 Markdown 格式呈现，方便LLM客户端直接展示或进一步处理。

安装步骤

  1. 安装 Node.js 和 npm: 确保你的系统中已安装 Node.js 和 npm (Node 包管理器)。
  2. 克隆仓库: 使用 Git 克隆该仓库到本地： 
    git clone https://github.com/cgoinglove/mcp-server-kakao-map.git
  3. 进入仓库目录: 导航到克隆下来的仓库目录： 
    cd mcp-server-kakao-map
  4. 安装依赖: 使用 npm 安装项目依赖： 
    npm install
  5. 配置 Kakao API 密钥:
    • 前往 Kakao开发者网站 注册并创建应用。
    • 在应用设置中获取 REST API 密钥。
    • 设置名为 'KAKAO_API_KEY' 的环境变量，并将你的 REST API 密钥设置为其值。

服务器配置

MCP 客户端需要配置以下信息以连接到此 MCP 服务器：

{
  "serverName": "mcp-server-kakao-map",
  "command": "node",
  "args": ["dist/index.js"]
}
  • 'serverName': 服务器名称，可以自定义，用于在客户端标识该服务器。
  • 'command': 启动服务器的命令，这里使用 'node' 运行 Node.js 程序。
  • 'args': 传递给 'node' 命令的参数，'dist/index.js' 是编译后的服务器入口文件。

注意: 请确保在运行 MCP 客户端时，'KAKAO_API_KEY' 环境变量在服务器运行环境中已正确设置。

基本使用方法

  1. 启动服务器: 在仓库目录下，使用以下命令启动 MCP 服务器： 
    npm start
    或者直接运行入口文件 (如果你已经构建了项目): 
    node dist/index.js
  2. 配置 MCP 客户端: 在你的 MCP 客户端应用中，配置上述服务器配置信息，以便客户端能够连接到此服务器。
  3. 调用工具: 客户端连接成功后，即可调用 'kakao_map_place_recommender' 工具。调用时，需要提供 'query' 参数，该参数为描述你想查找的地点类型和位置的韩语关键词，例如 '"강남역 맛집"' (江南站 美食)。
  4. 接收结果: 服务器将返回包含地点推荐信息的 JSON-RPC 响应，内容以 Markdown 格式组织，方便 LLM 应用进行展示或进一步处理。

信息

分类

网页与API

访问项目