Skip to main content
Glama
Sign In
deenesjakoruzh

Kakao Bot MCP Server

by inspirit941
GitHub
Python
1
  • Linux
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Integrates with Kakao Developers API to send various types of messages to a Kakao account, including text templates, feed templates, list templates, location templates, calendar templates, and commerce templates.

  • Enables sending different types of messages through KakaoTalk, including text, feed, list, location, calendar, and commerce templates with customizable content, buttons, and links.

カカオボットMCPサーバー

Kakao Developers API を統合して AI エージェントを Kakao 公式アカウントに接続するモデル コンテキスト プロトコル (MCP)サーバー実装。

MCP サーバーは、開発者 API と AI エージェントの両方を備えています。

[!NOTE] このリポジトリは、Kakao によって正式に提供または保守されているわけではありません。完全な機能や包括的なサポートが含まれていない場合があります。 API を使用して、API を使用してください。 관리하고 있으므로、개인이 사용하기엔 제한적입니다。

例: https://developers.kakao.com/docs/latest/ko/kakaotalk-message/rest-api

예시

クロードデスクトップのMCPツールのインストール

「나에게 메시지 전달」 결과

ツール

すべてのツールでは、ユーザーの資格情報を識別するために__email_address__の入力が必要です。

  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 （オブジェクト、オプション）：フィードに追加されるアイテムコンテンツ。（ネスト構造についてはAPIドキュメントを参照してください）
      • social （オブジェクト、オプション）: いいね、コメントなどのソーシャル情報。（ネスト構造についてはAPIドキュメントを参照）
      • buttons （オブジェクトの配列、オプション）: メッセージに含めるボタン。（各オブジェクトにはtitleとlink必要です）
  3. リストテンプレートを私に送信
    • 説明: カカオトークリストメッセージを私に送信します。
    • 入力:
      • __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. 位置情報テンプレートを私に送信
    • 説明: カカオトークの位置情報メッセージを私に送信します。
    • 入力:
      • __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 (文字列、必須、列挙型: "event"): カレンダー項目の種類。
      • id (文字列、必須): カレンダー アイテムの ID。
      • buttons （オブジェクトの配列、オプション）：メッセージに含めるボタン。（各オブジェクトにはtitleとlink必要です）
  6. コマーステンプレートを私に送信
    • 説明: カカオトークコマースメッセージを私に送信します。
    • 入力:
      • __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 からのアクセス

クイックスタートを実行してください。

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

비즈 앱 등록。 사업자번호가 없어도 "개인 개발자 비즈 앱" 등록이 가능하다。

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

  • 제품 설정 > 카카오 로그인 > 동의항목에서 '닉네임', '카카오계정(이메일)', '카카오톡 메시지 전송' 을 활성화한다。
  • OpenID 활성화한다。
ステップ 2. 로컬환경 설정

uv を保存します。

git clone git@github.com:inspirit941/kakao-bot-mcp-server.git cd kakao-bot-mcp-server pip install uv uv sync # inspector 실행 npx @modelcontextprotocol/inspector uv --directory . run mcp-kakao # MCP server 실행 uv run mcp-kakao

정상적으로 동작하려면 두 개의 일본 필요하다。 .accounts.json 、 .kauth.json 프로젝트 ルート ディレクトリに保存されます。

.accounts.json

{ "accounts": [ { "email": "your-email@kakao.com", "account_type": "personal", "extra_info": "Additional info that you want to tell Claude: E.g. 'Contains Family Calendar'" } ] }
  • メール: 카카오 계정 이메일주소。
  • account_type: 個人アカウント。
  • extra_info: MCP サーバーがサポートされています。

.kauth.json

{ "web": { "client_id": "rest-api-key", "auth_uri": "https://kauth.kakao.com/oauth/authorize", "token_uri": "https://kauth.kakao.com/oauth/token", "client_secret": "your_client_secret", "redirect_uris": ["http://localhost:8000/code"], "revoke_uri": "https://kapi.kakao.com/v2/user/revoke/scopes", "token_info_uri": "https://kauth.kakao.com/oauth/tokeninfo" } }
  • client_id: 애플리케이션에서 제공하는 REST_API キー
  • client_secret: client_secret を使用します。 임의의 문자열을 넣어도 동작함
  • 나머지 필드는 고정。

クロードデスクトップ

{ "mcpServers": { "mcp-kakao": { "command": "uv", "args": [ "--directory", "your-project-path/kakao-bot-mcp-server", "run", "mcp-kakao" ] } } }

동작 방식

LLM または MCP ツールの機能

  • 프로젝트 root 경로에 .oauth2.<카카오메일주소>.json peeping 있는지 확인한다。
    • OAuth2 がサポートされています。 ( https://accounts.kakao.com/login?Continue= ...)
    • 토큰이 만료되지 않았는지 확인한다。更新トークンは、トークンを更新します。リフレッシュ トークンは、ツールの URL を保持します。
  • .oauth2.<카카오메일주소>.json 이름으로 access_token の名前저장한다。

MCP ツールは json のアクセス トークンを保持します。

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

AI エージェントを Kakao 公式アカウントに接続し、ユーザーが Kakao Developers API を通じてさまざまなメッセージ テンプレートを送信できるようにするモデル コンテキスト プロトコルの実装。

  1. 예시
    1. ツール
      1. インストール

    Related MCP Servers

    • Kafka MCP Server

      pavanjava
      -
      security
      A
      license
      -
      quality
      Enables AI models to publish and consume messages from Apache Kafka topics through a standardized interface, making it easy to integrate Kafka messaging with LLM and agent applications.
      Last updated -
      10
      Python
      Apache 2.0
      • Linux
      • Apple

    • MCP Twitter

      0xhijo
      -
      security
      A
      license
      -
      quality
      A Model Context Protocol server that enables AI models and applications to interact directly with Twitter/X, providing capabilities to create posts, reply to tweets, retrieve user data, and manage account actions.
      Last updated -
      87
      4
      TypeScript
      MIT License

    • Aligo SMS MCP Server

      hongsw
      -
      security
      A
      license
      -
      quality
      A Model Context Protocol (MCP) server that allows AI agents like Claude to interact with the Aligo SMS API to send text messages and retrieve related information.
      Last updated -
      JavaScript
      MIT License

    • Kaltura MCP Server

      zoharbabin
      -
      security
      A
      license
      -
      quality
      An implementation of the Model Context Protocol that provides AI models with standardized access to Kaltura's media management capabilities including uploading, retrieving metadata, searching, and managing categories and permissions.
      Last updated -
      1
      Python
      MIT License
      • Linux
      • Apple

    View all related MCP servers

    New MCP Servers

    ID: os176oyqfq