카카오 API MCP 서버

카카오 API MCP 서버

site icon
2025.04.03 7
TypeScript地图服务搜索服务位置服务搜索工具
kakao-api-mcp-server 是一个通过 Model Context Protocol (MCP) 提供 Kakao Map API 和 Daum 搜索 API 功能的服务器。它允许 AI 模型利用 Kakao Map 的地图相关功能和 Daum 的多样化搜索功能。
View on GitHub

Overview

产品定位

kakao-api-mcp-server 是一个中间件服务,旨在通过 MCP 协议将 Kakao Map 和 Daum 搜索的 API 功能暴露给 AI 模型或其他客户端使用。

核心功能

Kakao Map API

  1. 地点搜索 (mcp_kakao_map_search_places)
  2. 通过关键词搜索地点
  3. 提供位置、类别、联系信息

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

  5. 将经纬度坐标转换为实际地址
  6. 提供道路地址和地段地址信息

  7. 路线导航 (mcp_kakao_map_find_route)

  8. 搜索从起点到终点的路线
  9. 提供距离、预计时间、预计出租车费用等信息
  10. 可选包含交通状况信息

Daum 搜索 API

  1. 网页文档搜索 (mcp_kakao_map_search_web)
  2. 图片搜索 (mcp_kakao_map_search_image)
  3. 博客搜索 (mcp_kakao_map_search_blog)
  4. 论坛搜索 (mcp_kakao_map_search_cafe)

适用场景

  • 需要集成 Kakao Map 地图服务的 AI 应用
  • 需要访问 Daum 搜索内容的应用程序
  • 需要将坐标转换为地址的服务
  • 需要提供路线导航功能的应用

工具列表

  1. mcp_kakao_map_search_places - 地点搜索工具
  2. mcp_kakao_map_coord_to_address - 坐标地址转换工具
  3. mcp_kakao_map_find_route - 路线导航工具
  4. mcp_kakao_map_search_web - 网页搜索工具
  5. mcp_kakao_map_search_image - 图片搜索工具
  6. mcp_kakao_map_search_blog - 博客搜索工具
  7. mcp_kakao_map_search_cafe - 论坛搜索工具

常见问题解答

  1. 是否需要 Kakao 开发者账号?
  2. 是的,需要有效的 Kakao REST API 密钥

  3. 是否支持用户账户相关功能?

  4. 不支持,仅使用公开的 Open API

  5. 支持哪些运行模式?

  6. HTTP 模式和 stdio 模式

使用教程

使用依赖

  1. 确保已安装 Node.js 和 yarn

安装教程

git clone https://github.com/yousleepwhen/kakao-api-mcp-server.git
cd kakao-api-mcp-server
yarn install

配置环境变量

创建 .env 文件并添加:

KAKAO_REST_API_KEY=your_api_key_here

调试方式

HTTP 模式

yarn start

stdio 模式

yarn start:stdio

开发模式

yarn dev

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。