卡卡奥 API MCP 服务器

这是一个通过 Model Context Protocol(MCP) 利用卡卡奥地图 API 和 Daum 搜索 API 的服务器。通过这个服务器，AI 模型可以利用卡卡奥地图的相关功能以及 Daum 的多种搜索功能。

注意事项

• 不包括用户账户相关的功能，如卡卡奥登录或发送卡卡奥消息。 本服务器仅使用公开的卡卡奥和 Daum 的 Open API。
• 使用本服务器需要有效的 卡卡奥 REST API 密钥。请在 卡卡奥开发者平台 创建应用并获取 REST API 密钥。

主要功能

卡卡奥地图 API

1. 地点搜索 (mcp_kakao_map_search_places)

   • 根据关键词搜索卡卡奥地图上的地点
   • 提供位置、类别、联系方式信息

2. 坐标-地址转换 (mcp_kakao_map_coord_to_address)

   • 将经纬度坐标转换为实际地址
   • 提供道路名称地址及地名地址信息

3. 路线查找 (mcp_kakao_map_find_route)

   • 查找从出发地到目的地的路径
   • 提供距离、预计时间、预计出租车费用等
   • 包含交通状况信息（可选）

Daum 搜索 API

1. 网页文档搜索 (mcp_kakao_map_search_web)

   • 根据关键词搜索 Daum 网页文档
   • 可调整页面排序及搜索结果数量

2. 图像搜索 (mcp_kakao_map_search_image)

   • 根据关键词搜索 Daum 图像
   • 提供图像 URL 及相关信息

3. 博客搜索 (mcp_kakao_map_search_blog)

   • 根据关键词搜索 Daum 博客文章
   • 提供博客名称、帖子标题、内容摘要

4. 咖啡厅搜索 (mcp_kakao_map_search_cafe)

   • 根据关键词搜索 Daum 咖啡厅文章
   • 提供咖啡厅名称、帖子标题、内容摘要

工具使用示例 (MCP)

以下是 MCP 客户端（例如 AI 模型）调用此服务器工具的方法及其预期响应格式。

卡卡奥地图 API

1. 地点搜索 (mcp_kakao_map_search_places)

请求：

{
  "tool_name": "mcp_kakao_map_search_places",
  "parameters": {
    "keyword": "판교역 현대백화점"
  }
}

响应（示例）：

{
  "tool_name": "mcp_kakao_map_search_places",
  "result": "地点搜索结果（共18个，显示15个）：\n名称：现代百货店盘谷店\n地址：京畿道城南市盆唐区白岘洞541\n类别：购物、流通 > 百货店 > 现代百货店\n电话号码：031-5170-2233\n详细信息：http://place.map.kakao.com/18757447\n---\n...（更多结果）"
}

2. 坐标-地址转换 (mcp_kakao_map_coord_to_address)

请求：

{
  "tool_name": "mcp_kakao_map_coord_to_address",
  "parameters": {
    "x": 127.1120278,
    "y": 37.3955833
  }
}

响应（示例）：

{
  "tool_name": "mcp_kakao_map_coord_to_address",
  "result": "坐标-地址转换结果：\n道路名称：京畿道城南市盆唐区盘谷站路146号20\n地名：京畿道城南市盆唐区白岘洞535"
}

3. 路线查找 (mcp_kakao_map_find_route)

请求：

{
  "tool_name": "mcp_kakao_map_find_route",
  "parameters": {
    "origin": "盘谷站",
    "destination": "正子站",
    "transportation_type": "car",
    "traffic_info": true
  }
}

响应（示例）：

{
  "tool_name": "mcp_kakao_map_find_route",
  "result": "🗺️ 路线查找结果\n\n出发地：盘谷站新分当线（京畿道城南市盆唐区三平洞）\n\n目的地：正子站新分当线（京畿道城南市盆唐区正子洞）\n\n交通工具：汽车\n\n总距离：3.6公里\n预计时间：10分钟\n预计出租车费用：5,600韩元\n\n📊 交通状况概要：\n\n查看卡卡奥地图：https://map.kakao.com/?sName=%ED%8C%90%EA%B5%90%EC%97%AD&eName=%EC%A0%95%EC%9E%90%EC%97%AD\n"
}

Daum 搜索 API

1. 网页文档搜索 (mcp_kakao_map_search_web)

请求：

{
  "tool_name": "mcp_kakao_map_search_web",
  "parameters": {
    "query": "卡卡奥大脑 卡洛",
    "size": 2
  }
}

响应（示例）：

{
  "tool_name": "mcp_kakao_map_search_web",
  "result": "网页文档搜索结果（共2083个，显示2个）：\n\n1. 卡卡奥大脑 | 卡洛 Karlo\n   内容：卡卡奥大脑的图像生成模型 Karlo 是一种人工智能画家，它理解用户输入的句子（Text），并生成独一无二的图像。数百万张图片规模的...\n   URL：https://kakaobrain.com/karlo\n   日期：2024. 1. 1.\n\n2. 卡卡奥大脑，AI艺术家“卡洛 2.0”发布 - 技术食谱\n   内容：卡卡奥大脑宣布于11日发布了超大规模的人工智能图像生成模型“卡洛(Karlo) 2.0”。卡洛 2.0 是一个基于约3亿张图片规模的文本-图像数据集训练的模型...\n   URL：https://techrecipe.co.kr/posts/56513\n   日期：2023. 7. 11.\n\n当前页面不是最后一页。若要查看更多结果，请增加 page 参数。\n"
}

2. 图像搜索 (mcp_kakao_map_search_image)

请求：

{
  "tool_name": "mcp_kakao_map_search_image",
  "parameters": {
    "query": "猫",
    "size": 1
  }
}

响应（示例）：

{
  "tool_name": "mcp_kakao_map_search_image",
  "result": "图像搜索结果（共8715385个，显示1个）：\n\n1. 集合名称：Daum 百科\n   文档 URL：http://100.daum.net/encyclopedia/view/172XX61300001\n   图像 URL：https://t1.daumcdn.net/thumb/R1024x0/?fname=http%3A%2F%2Ft1.daumcdn.net%2Fencyclop%2F172%2F613%2F172XX61300001\n   缩略图 URL：https://search1.kakaocdn.net/thumb/R100x100/?fname=http%3A%2F%2Ft1.daumcdn.net%2Fencyclop%2F172%2F613%2F172XX61300001&token=1579057346066cfd0b2e0c671d07c433\n   尺寸：宽1024像素，高682像素\n   显示 URL：100.daum.net\n   日期：2014. 11. 6.\n\n当前页面不是最后一页。若要查看更多结果，请增加 page 参数。\n"
}

3. 博客搜索 (mcp_kakao_map_search_blog)

请求：

{
  "tool_name": "mcp_kakao_map_search_blog",
  "parameters": {
    "query": "盘谷美食",
    "size": 1
  }
}

响应（示例）：

{
  "tool_name": "mcp_kakao_map_search_blog",
  "result": "博客搜索结果（共215893个，显示1个）：\n\n1. 博客名：壮刀的一般日常\n   标题：盘谷美食推荐 | Youth Space Mall 高性价比午餐美食\n   内容：盘谷科技谷 Youth Space Mall 在午餐时间总是人山人海。今天为大家推荐两个不错的午餐地点。1.... \n   URL：http://jdcamping.tistory.com/1374\n   缩略图：https://search2.kakaocdn.net/thumb/R180x180/?fname=https%3A%2F%2Fblog.kakaocdn.net%2Fdn%2FcQv0tX%2FbtrOfR4oUu3%2FdKQGkK0kY6kKk40f4kYkYK%2Fimg.jpg&token=1c251bb24ae4bb01657303012e2641ac\n   日期：2024. 12. 17.\n\n当前页面不是最后一页。若要查看更多结果，请增加 page 参数。\n"
}

4. 咖啡厅搜索 (mcp_kakao_map_search_cafe)

请求：

{
  "tool_name": "mcp_kakao_map_search_cafe",
  "parameters": {
    "query": "编程学习",
    "size": 1
  }
}

响应（示例）：

{
  "tool_name": "mcp_kakao_map_search_cafe",
  "result": "咖啡厅搜索结果（共18335个，显示1个）：\n\n1. 咖啡厅名：独取舍-就业、大学生、大企业、公企业、NCS、人格性、就业咖啡厅\n   标题：[学习] Web开发/编程基础学习招募\n   内容：大家好！正在寻找一起学习Web开发和编程基础的学习伙伴。目前已有2人，最多可容纳4人。地点主要在江南/沙堂进行，也可以在线上...\n   URL：http://cafe.daum.net/breakjob/DldL/12345\n   缩略图：https://search1.kakaocdn.net/thumb/P180x180/?fname=https%3A%2F%2Ft1.daumcdn.net%2Fcafe_image%2F%2Fconfig%2Fimg_default_profile%3Fver%3D1&token=de43b9d06222d0a2192f9f70fcb0f134\n   日期：2025. 3. 28.\n\n当前页面不是最后一页。若要查看更多结果，请增加 page 参数。\n"
}

安装与设置

1. 复制存储库并安装依赖项：

git clone https://github.com/yousleepwhen/kakao-api-mcp-server.git # 请将存储库 URL 替换为实际 URL
cd kakao-api-mcp-server
yarn install

• 推荐使用 yarn 包管理器。

2. 设置卡卡奥 REST API 密钥：
   • 在项目根目录创建 .env 文件。
   • 在 .env 文件中输入从卡卡奥开发者平台获取的 REST API 密钥：

     KAKAO_REST_API_KEY=在这里输入卡卡奥REST API密钥
     

   • 或者，在启动服务器时通过 --kakao-api-key 参数直接传递。

运行方法

在运行服务器之前需要构建代码。start 相关脚本已包含构建过程，因此无需单独执行 yarn build。

HTTP 模式（默认）

与其他服务或工具通过 HTTP 通信时使用。

yarn start

默认使用 3000 端口。如需更改端口，请使用 --port 参数：

yarn start --port 8080

stdio 模式

通过终端的标准输入输出（stdin/stdout）交换 MCP 消息时使用。

yarn start:stdio

开发模式

在开发过程中，当代码变更时自动构建并重启服务器（需要额外配置如 nodemon），可以使用 dev 脚本。当前 dev 脚本与 start 脚本相同。

yarn dev

许可证

本项目在 MIT 许可证下发布。