Kakao Bot MCP Server

Kakao Bot MCP 服务器

• Kakao Bot MCP 服务器
• 예시
• 工具
  • 安装
    • 步骤1.developers.kakao.com 에서 카카오 애플리케应
    • 步骤 2. 로컬환경 설정

模型上下文协议 (MCP)服务器实现集成了 Kakao 开发者 API，将 AI 代理连接到 Kakao 官方帐户。

MCP 服务器 구현체로, 카카오 Developers API를 AI Agent에 통합하는 예시입니다。

[!注意] 此存储库不是由 Kakao 官方提供或维护的。它可能不包括完整的功能或全面的支持。 카카오의 경우 대부분의 APIі 사업자등록기포함된 비즈니스 애플리케션 단위로 권한을请注意，请注意以下事项。

下载： https://developers.kakao.com/docs/latest/ko/kakaotalk-message/rest-api

예시

claude 桌面应用 MCP 工具应用

'나에게 메시지 전달' 결과

工具

所有工具都需要__email_address__输入来识别用户的凭证。

• 작성시점 기준, '나에게 보내기 - 기본 템플릿' API 만 지원됩니다。
• 下载：https: //developers.kakao.com/docs/latest/ko/kakaotalk-message/rest-api#default-template-msg-me

1. 发送文本模板给我
   • 描述：向我发送 Kakao Talk 短信。
   • 输入：
     • __email_address__ （字符串，必需）：与 Kakao 帐户关联的电子邮件地址。
     • text （字符串，必需，最多 200 个字符）：消息的文本内容。
     • link （对象，必需）：定义与文本相关的链接的对象。
       • web_url （字符串，可选，uri 格式）
       • mobile_web_url （字符串，可选，uri 格式）
     • button_title （字符串，可选）：按钮的标题。
2. 发送订阅源模板给我
   • 描述：向我发送 Kakao Talk 动态消息。
   • 输入：
     • __email_address__ （字符串，必需）
     • content （对象，必需）：提要消息的主要内容块。
       • title （字符串，必需）
       • description （字符串，必需）
       • image_url （字符串，必需，uri格式）
       • image_width （整数，可选）
       • image_height （整数，可选）
       • link （对象，必需） - 定义内容的链接
         • web_url （字符串，可选，uri 格式）
         • mobile_web_url （字符串，可选，uri 格式）
         • android_execution_params （字符串，可选）
         • ios_execution_params （字符串，可选）
     • item_content （对象，可选）：Feed 的附加项目内容。（有关嵌套结构，请参阅 API 文档）
     • social （对象，可选）：社交信息，如喜欢、评论等。（有关嵌套结构，请参阅 API 文档）
     • buttons （对象数组，可选）：要包含在消息中的按钮。（每个对象都需要title和link ）
3. 发送列表模板给我
   • 描述：向我发送 Kakao Talk 列表消息。
   • 输入：
     • __email_address__ （字符串，必需）
     • header_title （字符串，必需）：显示在列表顶部的标题。
     • contents （对象数组，必需）：内容项列表。每个内容项都需要：
       • title （字符串，必需）
       • description （字符串，必需）
       • image_url （字符串，必需，uri 格式）
       • image_width （整数，可选）
       • image_height （整数，可选）
       • link （对象，必需） - 定义列表项的链接
         • web_url （字符串，可选，uri 格式）
         • mobile_web_url （字符串，可选，uri 格式）
         • android_execution_params （字符串，可选）
         • ios_execution_params （字符串，可选）
     • header_link （对象，可选）：标题区域的链接。（有关嵌套结构，请参阅 API 文档）
     • buttons （对象数组，可选）：要包含在消息中的按钮。（每个对象都需要title和link ）
4. 发送位置模板给我
   • 描述：向我发送 Kakao Talk 位置消息。
   • 输入：
     • __email_address__ （字符串，必需）
     • content （对象，必需）：位置消息的主要内容块。
       • title （字符串，必需）
       • description （字符串，必需）
       • image_url （字符串，必需，uri格式）
       • image_width （整数，可选）
       • image_height （整数，可选）
       • link （对象，必需） - 定义内容的链接
         • web_url （字符串，可选，uri 格式）
         • mobile_web_url （字符串，可选，uri 格式）
         • android_execution_params （字符串，可选）
         • ios_execution_params （字符串，可选）
     • address （字符串，必需）：位置的地址。
     • buttons （对象数组，可选）：要包含在消息中的按钮。（每个对象都需要title和link ）
     • address_title （字符串，可选）：地址的标题。
5. 发送日历模板给我
   • 描述：向我发送 Kakao Talk 日历消息。
   • 输入：
     • __email_address__ （字符串，必需）
     • content （对象，必需）：日历消息的主要内容块。
       • title （字符串，必需）
       • description （字符串，必需）
       • link （对象，必需） - 定义内容的链接
         • web_url （字符串，可选，uri 格式）
         • mobile_web_url （字符串，可选，uri 格式）
         • android_execution_params （字符串，可选）
         • ios_execution_params （字符串，可选）
       • image_url （字符串，可选，uri 格式）
     • id_type （字符串，必需，枚举：“事件”）：日历项目的类型。
     • id （字符串，必需）：日历项目的 ID。
     • buttons （对象数组，可选）：要包含在消息中的按钮。（每个对象都需要title和link ）
6. 发送商务模板给我
   • 描述：向我发送 Kakao Talk 商务消息。
   • 输入：
     • __email_address__ （字符串，必需）
     • content （对象，必需）：商业信息的主要内容块。
       • title （字符串，必需）
       • image_url （字符串，必需，uri 格式）
       • image_width （整数，可选）
       • image_height （整数，可选）
       • link （对象，必需） - 定义内容的链接
         • web_url （字符串，可选，uri 格式）
         • mobile_web_url （字符串，可选，uri 格式）
         • android_execution_params （字符串，可选）
         • ios_execution_params （字符串，可选）
     • commerce （对象，必需）：特定于商业的信息。
       • regular_price （整数，必需）
       • discount_price （整数，可选）
       • discount_rate （整数，可选，0-100）
     • buttons （对象数组，可选）：要包含在消息中的按钮。（每个对象都需要title和link ）

安装

要求：Python 3.13+

카카오 계정 필요

步骤1.developers.kakao.com 에서 카카오 애플리케应

您可以使用快速入门指南来快速入门。

"내 애플리케 Been 도메인으로 > 앱 설정 > 플랫폼" 의 Web에서 도메인으로 http://localhost:8000 등록

비즈 앱 등록。 사업자번호і 없어도 “개인 개발자 비즈 앱” 등록א 능하다。

카카오 로그인을 활성화한다。

• 제품 설정 > 카카오 로그인 > 동의항목에서 '닉네임', '카카오계정( Been메일)', '카카오톡 메시지 전송' 을 활성화한다。
• OpenID 关闭。

步骤 2. 로컬환경 설정

紫外线会导致紫外线照射。

정상적으로 동작하려면 두 개의 파일 Been 필요하다。 .accounts.json 、 .kauth.json是根目录。

.accounts.json

• 电子邮件： 카카오 계정 Been 메일주소。
• account_type：个人账户。
• extra_info: MCP 服务器配置。

.kauth.json

• client_id: 카카오 애플리케 Been션에서 제공하는 REST_API 密钥
• client_secret: 客户端秘密是指客户端的秘密。 임의의 문자열을 넣어도 동작함
• 나머지 필드는 고정。

克劳德 桌面 설정

동작 방식

LLM 和 MCP Tool실행하면

• 프로젝트 root 경로에 .oauth2.<카카오메일주소>.json 파일 Been 있는지 확인한다。
  • 关闭后，OAuth2 会自动更新。 ( https://accounts.kakao.com/login?continue= ...)
  • 关闭后，关闭电源。请注意，刷新令牌으로 재발급받는다。刷新令牌可以使用以下工具，工具可以使用 url 来更新。
• 로그인에 성공하면, 프로젝트 root 경로에 .oauth2.<카카오메일주소>.json ה름으로 access_token 정보를 저장한다。

MCP 工具使用 json 来提供访问令牌。