Skip to main content
Glama
Sign In
enesjakozh

Kakao API MCP Server

by jeong-sik
GitHub
TypeScript
MIT License
3
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Supports configuration through .env files for storing API keys and other sensitive information.

  • Supports repository cloning as part of the installation process.

  • Provides tools for utilizing Kakao Map API (place search, coordinate-to-address conversion, route finding) and Daum Search API (web, image, blog, and cafe content search) through standardized MCP endpoints.

Servidor MCP de la API de Kakao

Este es un servidor que puede utilizar Kakao Map API y Daum Search API a través del Protocolo de contexto de modelo (MCP). Este servidor permite que los modelos de IA utilicen las funciones relacionadas con los mapas de Kakao Map y las diversas funciones de búsqueda de Daum.

precaución

  • Las funciones relacionadas con la cuenta de usuario, como el inicio de sesión de Kakao y el envío de mensajes de KakaoTalk, no están incluidas. Este servidor solo utiliza las API públicas de Kakao y Daum.
  • Se requiere una clave API REST de Kakao válida para utilizar este servidor. Cree una aplicación en Kakao Developers y obtenga una clave API REST.

Características principales

API de mapas de Kakao

  1. Buscar lugares ( mcp_kakao_map_search_places )
    • Buscar lugares en Kakao Map por palabra clave
    • Proporcionar ubicación, categoría e información de contacto
  2. Conversión de coordenadas a direcciones ( mcp_kakao_map_coord_to_address )
    • Convertir coordenadas de latitud y longitud en direcciones reales
    • Proporcionar información sobre la dirección del nombre de la calle y la dirección del número de lote
  3. Encontrar direcciones ( mcp_kakao_map_find_route )
    • Buscar ruta desde el origen hasta el destino
    • Proporciona distancia, tiempo de viaje, tarifa de taxi estimada, etc.
    • Incluir información de tráfico (opcional)

API de búsqueda de Daum

  1. Búsqueda de documentos web ( mcp_kakao_map_search_web )
    • Busque los siguientes documentos web por palabra clave
    • Capacidad de ajustar la clasificación de páginas y el número de resultados de búsqueda
  2. Búsqueda de imágenes ( mcp_kakao_map_search_image )
    • Buscar la siguiente imagen por palabra clave
    • Proporcionar la URL de la imagen y la información relacionada
  3. Búsqueda de blogs ( mcp_kakao_map_search_blog )
    • Busque las siguientes publicaciones del blog por palabra clave
    • Proporcionar el nombre del blog, el título de la publicación y un resumen del contenido.
  4. Búsqueda de cafeterías ( mcp_kakao_map_search_cafe )
    • Buscar artículos de Daum Café por palabra clave
    • Proporcione el nombre de la cafetería, el título de la publicación y un resumen del contenido.

Ejemplo de uso de herramientas (MCP)

A continuación se muestra cómo un cliente MCP (por ejemplo, un modelo de IA) llama a una herramienta en este servidor y el formato de respuesta esperado.

API de mapas de Kakao

1. Buscar lugares ( mcp_kakao_map_search_places )

Pedido:

{ "tool_name": "mcp_kakao_map_search_places", "parameters": { "keyword": "판교역 현대백화점" } }

Respuesta (Ejemplo):

{ "tool_name": "mcp_kakao_map_search_places", "result": "장소 검색 결과 (결과 수: 15, 총 18개):\n이름: 현대백화점 판교점\n주소: 경기 성남시 분당구 백현동 541\n카테고리: 쇼핑,유통 > 백화점 > 현대백화점\n전화번호: 031-5170-2233\n상세정보: http://place.map.kakao.com/18757447\n---\n... (추가 결과)" }

2. Conversión de coordenadas a direcciones ( mcp_kakao_map_coord_to_address )

Pedido:

{ "tool_name": "mcp_kakao_map_coord_to_address", "parameters": { "x": 127.1120278, "y": 37.3955833 } }

Respuesta (Ejemplo):

{ "tool_name": "mcp_kakao_map_coord_to_address", "result": "주소 변환 결과:\n도로명: 경기 성남시 분당구 판교역로146번길 20\n지번: 경기 성남시 분당구 백현동 535" }

3. Encontrar direcciones ( mcp_kakao_map_find_route )

Pedido:

{ "tool_name": "mcp_kakao_map_find_route", "parameters": { "origin": "판교역", "destination": "정자역", "transportation_type": "car", "traffic_info": true } }

Respuesta (Ejemplo):

{ "tool_name": "mcp_kakao_map_find_route", "result": "🗺️ 길찾기 결과\n\n출발지: 판교역 신분당선 (경기 성남시 분당구 삼평동)\n\n목적지: 정자역 신분당선 (경기 성남시 분당구 정자동)\n\n이동 수단: 자동차\n\n총 거리: 3.6km\n예상 소요 시간: 10분\n예상 택시 요금: 5,600원\n\n📊 교통 상황 요약:\n\n카카오맵에서 보기: https://map.kakao.com/?sName=%ED%8C%90%EA%B5%90%EC%97%AD&eName=%EC%A0%95%EC%9E%90%EC%97%AD\n" }

API de búsqueda de Daum

1. Búsqueda de documentos web ( mcp_kakao_map_search_web )

Pedido:

{ "tool_name": "mcp_kakao_map_search_web", "parameters": { "query": "카카오브레인 칼로", "size": 2 } }

Respuesta (Ejemplo):

{ "tool_name": "mcp_kakao_map_search_web", "result": "웹 문서 검색 결과 (총 2083개 중 2개 표시):\n\n1. 카카오브레인 | 칼로 Karlo\n 내용: 카카오브레인의 이미지 생성 모델 Karlo는 사용자가 입력한 문장(Text)을 이해하여, 세상에 단 하나뿐인 이미지를 만들어내는 인공지능 화가입니다. 수백만 장 규모의...\n URL: https://kakaobrain.com/karlo\n 날짜: 2024. 1. 1.\n\n2. 카카오브레인, AI 아티스트 '칼로 2.0' 공개 - 테크레시피\n 내용: 카카오브레인이 초거대 인공지능(AI) 이미지 생성 모델 '칼로(Karlo) 2.0'을 공개했다고 11일 밝혔다. 칼로 2.0은 약 3억 장 규모의 텍스트-이미지 데이터셋을 학습한 모델이...\n URL: https://techrecipe.co.kr/posts/56513\n 날짜: 2023. 7. 11.\n\n현재 페이지가 마지막 페이지가 아닙니다. 더 많은 결과를 보려면 page 매개변수를 증가시키세요.\n" }

2. Búsqueda de imágenes ( mcp_kakao_map_search_image )

Pedido:

{ "tool_name": "mcp_kakao_map_search_image", "parameters": { "query": "고양이", "size": 1 } }

Respuesta (Ejemplo):

{ "tool_name": "mcp_kakao_map_search_image", "result": "이미지 검색 결과 (총 8715385개 중 1개 표시):\n\n1. 컬렉션 이름: Daum 백과\n 문서 URL: http://100.daum.net/encyclopedia/view/172XX61300001\n 이미지 URL: https://t1.daumcdn.net/thumb/R1024x0/?fname=http%3A%2F%2Ft1.daumcdn.net%2Fencyclop%2F172%2F613%2F172XX61300001\n 썸네일 URL: https://search1.kakaocdn.net/thumb/R100x100/?fname=http%3A%2F%2Ft1.daumcdn.net%2Fencyclop%2F172%2F613%2F172XX61300001&token=1579057346066cfd0b2e0c671d07c433\n 크기: 가로 1024px, 세로 682px\n 표시 URL: 100.daum.net\n 날짜: 2014. 11. 6.\n\n현재 페이지가 마지막 페이지가 아닙니다. 더 많은 결과를 보려면 page 매개변수를 증가시키세요.\n" }

3. Búsqueda de blogs ( mcp_kakao_map_search_blog )

Pedido:

{ "tool_name": "mcp_kakao_map_search_blog", "parameters": { "query": "판교 맛집", "size": 1 } }

Respuesta (Ejemplo):

{ "tool_name": "mcp_kakao_map_search_blog", "result": "블로그 검색 결과 (총 215893개 중 1개 표시):\n\n1. 블로그명: 짱돌의 일상다반사\n 제목: 판교 맛집 추천 | 유스페이스몰 가성비 좋은 점심 맛집\n 내용: 판교테크노밸리 유스페이스몰은 늘 점심시간마다 직장인들로 인산인해를 이루는 곳이다. 오늘은 판교 점심 맛집으로 괜찮은 곳 두 군데를 소개해 본다. 1.... \n URL: http://jdcamping.tistory.com/1374\n 썸네일: https://search2.kakaocdn.net/thumb/R180x180/?fname=https%3A%2F%2Fblog.kakaocdn.net%2Fdn%2FcQv0tX%2FbtrOfR4oUu3%2FdKQGkK0kY6kKk40f4kYkYK%2Fimg.jpg&token=1c251bb24ae4bb01657303012e2641ac\n 날짜: 2024. 12. 17.\n\n현재 페이지가 마지막 페이지가 아닙니다. 더 많은 결과를 보려면 page 매개변수를 증가시키세요.\n" }

4. Búsqueda de cafeterías ( mcp_kakao_map_search_cafe )

Pedido:

{ "tool_name": "mcp_kakao_map_search_cafe", "parameters": { "query": "코딩 스터디", "size": 1 } }

Respuesta (Ejemplo):

{ "tool_name": "mcp_kakao_map_search_cafe", "result": "카페 검색 결과 (총 18335개 중 1개 표시):\n\n1. 카페명: 독취사-취업,대학생,대기업,공기업,NCS,인적성,취업카페\n 제목: [스터디] 웹개발/코딩 기초 스터디 구해요\n 내용: 안녕하세요! 웹개발 및 코딩 기초를 함께 공부할 스터디원을 모집합니다. 현재 2명이며, 최대 4명까지 생각하고 있습니다. 장소는 주로 강남/사당에서 진행하고, 온라...\n URL: http://cafe.daum.net/breakjob/DldL/12345\n 썸네일: https://search1.kakaocdn.net/thumb/P180x180/?fname=https%3A%2F%2Ft1.daumcdn.net%2Fcafe_image%2F%2Fconfig%2Fimg_default_profile%3Fver%3D1&token=de43b9d06222d0a2192f9f70fcb0f134\n 날짜: 2025. 3. 28.\n\n현재 페이지가 마지막 페이지가 아닙니다. 더 많은 결과를 보려면 page 매개변수를 증가시키세요.\n" }

Instalación y configuración

  1. Clonar el repositorio e instalar las dependencias:
git clone https://github.com/yousleepwhen/kakao-api-mcp-server.git # 저장소 URL을 실제 URL로 변경해주세요 cd kakao-api-mcp-server yarn install
  • Este proyecto recomienda utilizar el administrador de paquetes de yarn .
  1. Configuración de la clave API REST de Kakao:
    • Cree un archivo .env en el directorio raíz de su proyecto.
    • Ingrese la clave API REST emitida por Kakao Developers en .env de la siguiente manera:
      KAKAO_REST_API_KEY=여기에_카카오_REST_API_키_입력
    • Alternativamente, puede pasarlo directamente a través --kakao-api-key al ejecutar el servidor.

Cómo correr

Debes compilar tu código antes de ejecutar el servidor. No es necesario ejecutar yarn build por separado, ya que el proceso de compilación está incluido en start .

Modo HTTP (predeterminado)

Se utiliza cuando se comunica con otros servicios o herramientas a través de HTTP.

yarn start

De forma predeterminada, se utiliza el puerto número 3000. Para cambiar el puerto, utilice --port :

yarn start --port 8080

modo estándar

Se utiliza para enviar y recibir mensajes MCP a través de la entrada/salida estándar del terminal (stdin/stdout).

yarn start:stdio

Modo de desarrollo

Si desea compilar y reiniciar automáticamente el servidor cuando el código cambia durante el desarrollo (requiere configuraciones separadas como nodemon), puede usar el script dev . Actualmente, el script dev se comporta de manera idéntica para start .

yarn dev

Licencia

Este proyecto se distribuye bajo la licencia MIT.

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

Un servidor que permite a los modelos de IA acceder a las funciones de Kakao Map (búsqueda de lugares, búsqueda de direcciones, búsqueda de rutas) y a los servicios de búsqueda de Daum (web, imágenes, blogs, cafeterías) a través del Protocolo de contexto de modelo.

  1. 주의 사항
    1. 주요 기능
      1. 카카오맵 API
      2. Daum 검색 API
    2. 도구 사용 예시 (MCP)
      1. 카카오맵 API
      2. Daum 검색 API
    3. 설치 및 설정
      1. 실행 방법
        1. HTTP 모드 (기본)
        2. stdio 모드
        3. 개발 모드
      2. 라이선스

        Appeared in Searches

        ID: 0dah3euqvs