Skip to main content
Glama
deenesjakoruzh
inspirit941

Kakao Bot MCP Server

by inspirit941
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

Сервер MCP Kakao Bot

Реализация сервера Model Context Protocol (MCP) , которая интегрирует API разработчиков Kakao для подключения AI-агента к официальному аккаунту Kakao.

Сервер MCP доступен, API для разработчиков и агент AI, который можно использовать.

NOTE

Этот репозиторий официально НЕ предоставляется и не поддерживается Kakao. Оно может не включать полную функциональность или всестороннюю поддержку. Используйте API-интерфейс, чтобы получить доступ к соответствующему API-интерфейсу. Если вы хотите, чтобы это произошло, вы можете сделать это.

Дополнительная информация: https://developers.kakao.com/docs/latest/ko/kakaotalk-message/rest-api

Related MCP server: SupaUI MCP Server

예시

Claude Desktop — инструмент 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. отправить_шаблон_списка_мне

    • Описание: Отправляет мне сообщение из списка 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 (string, required, enum: "event"): Тип элемента календаря.

      • 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.

Воспользуйтесь кратким руководством по быстрому началу работы .

사이트 등록

"내 애플리케이션 > 앱 설정 > 플랫폼" в веб-интерфейсе, например 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 key

  • client_secret: Чтобы открыть client_secret. 임의의 문자열을 넣어도 동작함

  • 나머지 필드는 고정.

Клод десктоп 설정

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

동작 방식

LLM и MCP Tool — это инструмент

  • Корневой файл 경로에 .oauth2.<카카오메일주소>.json 파일이 있는지 확인한다.

    • Если вы хотите использовать OAuth2, вы можете использовать его для проверки подлинности. ( https://accounts.kakao.com/login?continue= ...)

    • Если вы хотите, чтобы это произошло, вы можете сделать это в любой момент. Затем обновите токен. обновить токен 도 만료되었을 경우, инструмент 에서 로그인할 수 있는 url 주소를 리턴한다.

  • В случае необходимости, root 경로에 .oauth2.<카카오메일주소>.json 이름으로 access_token 정보를 저장한다.

Инструмент MCP — это токен доступа в формате json, который можно использовать.

This server cannot be installed

F
license - not found
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
1Releases (12mo)

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/inspirit941/kakao-bot-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server