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.
Related MCP server: Playwright MCP Server
Características principales
API de mapas de Kakao
Buscar lugares (
Buscar lugares en Kakao Map por palabra clave
Proporcionar ubicación, categoría e información de contacto
Conversión de coordenadas a direcciones (
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
Encontrar direcciones (
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
Búsqueda de documentos 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
Búsqueda de imágenes (
Buscar la siguiente imagen por palabra clave
Proporcionar la URL de la imagen y la información relacionada
Búsqueda de blogs (
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.
Búsqueda de cafeterías (
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
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 installEste proyecto recomienda utilizar el administrador de paquetes de
yarn.
Configuración de la clave API REST de Kakao:
Cree un archivo
.enven el directorio raíz de su proyecto.Ingrese la clave API REST emitida por Kakao Developers en
.envde la siguiente manera:KAKAO_REST_API_KEY=여기에_카카오_REST_API_키_입력Alternativamente, puede pasarlo directamente a través
--kakao-api-keyal 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 startDe forma predeterminada, se utiliza el puerto número 3000. Para cambiar el puerto, utilice --port :
yarn start --port 8080modo 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:stdioModo 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 devLicencia
Este proyecto se distribuye bajo la licencia MIT.
This server cannot be installed
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.