Kakao API MCP Server

Kakao API MCP 服务器

这是一个可以通过模型上下文协议（MCP）利用Kakao Map API和Daum Search API的服务器。该服务器允许AI模型利用Kakao Map的地图相关功能和Daum的各种搜索功能。

警告

• **不包括与用户帐户相关的功能，例如 Kakao 登录和发送 KakaoTalk 消息。**该服务器仅使用Kakao和Daum的公共API。
• 使用此服务器需要有效的Kakao REST API 密钥。在Kakao Developers创建一个应用程序并获取 REST API 密钥。

主要特点

Kakao地图API

1. 搜索地点（ mcp_kakao_map_search_places ）
   • 在 Kakao 地图上按关键字搜索地点
   • 提供位置、类别和联系信息
2. 坐标到地址的转换（ mcp_kakao_map_coord_to_address ）
   • 将经纬度坐标转换为真实地址
   • 提供道路名称地址和地段号码地址信息
3. 查找路线（ mcp_kakao_map_find_route ）
   • 搜索从出发地到目的地的路线
   • 提供距离、旅行时间、预计出租车费用等。
   • 包含交通信息（可选）

Daum 搜索 API

1. 网页文档搜索（ mcp_kakao_map_search_web ）
   • 通过关键字搜索以下网络文档
   • 能够调整页面排序和搜索结果数量
2. 图片搜索（ mcp_kakao_map_search_image ）
   • 按关键字搜索下一张图片
   • 提供图片URL及相关信息
3. 博客搜索（ mcp_kakao_map_search_blog ）
   • 按关键字搜索以下博客文章
   • 提供博客名称、文章标题和内容摘要
4. 咖啡馆搜索（ mcp_kakao_map_search_cafe ）
   • 通过关键字搜索 Daum Cafe 文章
   • 提供咖啡馆名称、帖子标题和内容摘要

工具使用示例（MCP）

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

Kakao地图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 ）

要求：

响应（示例）：

2. 图像搜索（ mcp_kakao_map_search_image ）

要求：

响应（示例）：

3. 博客搜索（ mcp_kakao_map_search_blog ）

要求：

响应（示例）：

4. 咖啡厅搜索 ( mcp_kakao_map_search_cafe )

要求：

响应（示例）：

安装和设置

1. 克隆存储库并安装依赖项：

• 该项目建议使用yarn包管理器。

2. 设置 Kakao REST API 密钥：
   • 在项目根目录中创建一个.env文件。
   • 在.env文件中输入 Kakao Developers 颁发的 REST API 密钥，如下所示：
     KAKAO_REST_API_KEY=여기에_카카오_REST_API_키_입력
   • 或者，您可以在运行服务器时通过--kakao-api-key参数直接传递它。

如何运行

您需要在运行服务器之前构建代码。不需要单独运行yarn build ，因为构建过程包含在start相关的脚本中。

HTTP 模式（默认）

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

默认情况下使用端口号 3000。要更改端口，请使用--port参数：

标准输入输出模式

用于通过终端的标准输入/输出（stdin/stdout）发送和接收 MCP 消息。

开发模式

如果希望在开发过程中代码发生变更时自动构建并重启服务器（需要单独设置如nodemon），可以使用dev脚本。目前， dev脚本的行为与start相同。

执照

该项目根据 MIT 许可证分发。