Kakao API MCP服务器
Kakao Map API和Daum搜索API 模型上下文协议（MCP）提供的服务器。通过该服务器，AI模型可以利用Kakao Map的地图相关功能和Daum的各种搜索功能。
注意事项
- 不包括Kakao登录、发送Kakao Talk消息等用户帐户相关功能。 此服务器仅使用公开的Kakao和Daum的Open API。
- 使用本服务器有效 Kakao REST API密钥需要。 Kakao Debellopus在中创建应用程序并获得REST API密钥。
主要功能
Kakao Map API
- 搜索地点（
mcp_kakao_map_search_places)
- 用关键字在Kakao地图上搜索地点 - 提供位置、类别和联系信息
- 坐标-地址转换（
mcp_kakao_map_coord_to_address)
- 将经纬度坐标转换为实际地址 - 提供道路名称地址和编号地址信息
- 寻路（
mcp_kakao_map_find_route)
- 搜索从起点到目的地的路径 - 提供距离、所需时间、预计出租车费用等 - 包括交通状况信息（可选）
Daum搜索API
- 搜索Web文档（
mcp_kakao_map_search_web)
- 使用关键字搜索以下Web文档 - 可以调整页面排序和搜索结果计数
- 搜索图像（
mcp_kakao_map_search_image)
- 使用关键字搜索以下图像 - 提供图像URL和相关信息
- 搜索博客（
mcp_kakao_map_search_blog)
- 使用关键字搜索以下博客文章 - 提供博客名称、文章标题和内容摘要
- 搜索咖啡厅（
mcp_kakao_map_search_cafe)
- 使用关键字搜索下一个社区的文章 - 提供咖啡厅名称、帖子标题和内容摘要
工具使用示例（MCP）
以下是MCP客户端（例如AI模型）如何调用此服务器上的工具以及预期的响应格式。
Kakao Map API
1.搜索地点（mcp_kakao_map_search_places)
请求：
{
"tool_name": "mcp_kakao_map_search_places",
"parameters": {
"keyword": "판교역 현대백화점"
}
}响应（Response-示例）：
{
"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.坐标-地址转换（mcp_kakao_map_coord_to_address)
请求：
{
"tool_name": "mcp_kakao_map_coord_to_address",
"parameters": {
"x": 127.1120278,
"y": 37.3955833
}
}响应（Response-示例）：
{
"tool_name": "mcp_kakao_map_coord_to_address",
"result": "주소 변환 결과:\n도로명: 경기 성남시 분당구 판교역로146번길 20\n지번: 경기 성남시 분당구 백현동 535"
}3.寻路（mcp_kakao_map_find_route)
请求：
{
"tool_name": "mcp_kakao_map_find_route",
"parameters": {
"origin": "판교역",
"destination": "정자역",
"transportation_type": "car",
"traffic_info": true
}
}响应（Response-示例）：
{
"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"
}Daum搜索API
1.搜索Web文档（mcp_kakao_map_search_web)
请求：
{
"tool_name": "mcp_kakao_map_search_web",
"parameters": {
"query": "카카오브레인 칼로",
"size": 2
}
}响应（Response-示例）：
{
"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.搜索图像（mcp_kakao_map_search_image)
请求：
{
"tool_name": "mcp_kakao_map_search_image",
"parameters": {
"query": "고양이",
"size": 1
}
}响应（Response-示例）：
{
"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.搜索博客（mcp_kakao_map_search_blog)
请求：
{
"tool_name": "mcp_kakao_map_search_blog",
"parameters": {
"query": "판교 맛집",
"size": 1
}
}响应（Response-示例）：
{
"tool_name": "mcp_kakao_map_search_blog",
"result": "블로그 검색 결과 (총 215893개 중 1개 표시):\n\n1. 블로그명: 짱돌의 일상다반사\n 제목: 판교 맛집 추천 | 유스페이스몰 가성비 좋은 점심 맛집\n 내용: 판교테크노밸리 유스페이스몰은 늘 점심시간마다 직장인들로 인산인해를 이루는 곳이다. 오늘은 판교 점심 맛집으로 괜찮은 곳 두 군데를 소개해 본다. 1.... \n URL: http://jdcamping.tistory.com/1374\n 썸네일: &token=1c251bb24ae4bb01657303012e2641ac\n 날짜: 2024. 12. 17.\n\n현재 페이지가 마지막 페이지가 아닙니다. 더 많은 결과를 보려면 page 매개변수를 증가시키세요.\n"
}4.搜索社区（mcp_kakao_map_search_cafe)
请求：
{
"tool_name": "mcp_kakao_map_search_cafe",
"parameters": {
"query": "코딩 스터디",
"size": 1
}
}响应（Response-示例）：
{
"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"
}安装和设置
- 复制存储库并安装依存关系：
git clone https://github.com/yousleepwhen/kakao-api-mcp-server.git # 저장소 URL을 실제 URL로 변경해주세요
cd kakao-api-mcp-server
yarn install- 这个项目
yarn建议使用包管理器。
- Kakao REST API密钥设置：
- 在项目根目录中 .env 创建文件。 - .env 在文件中输入Kakao Debellopus颁发的REST API密钥，如下所示：
KAKAO_REST_API_KEY=여기에_카카오_REST_API_키_입력- 或者，运行服务器时 --kakao-api-key 也可以通过参数直接传递。
执行方法
必须在运行服务器之前构建代码。 start 相关脚本包含构建过程，因此需要单独 yarn build不需要运行。
HTTP模式（默认）
用于通过HTTP与其他服务或工具进行通信。
yarn start默认情况下，使用端口3000。更改端口的步骤 --port 请使用参数：
yarn start --port 8080stdio模式
用于通过终端的标准I/O（stdin/stdout）收发MCP消息。
yarn start:stdio开发模式
要在开发期间更改代码时自动构建并重新启动服务器（需要单独设置nodemon等），请执行以下操作： dev 脚本。当前 dev 脚本 start的行为与相同。
yarn dev许可证
该项目在MIT许可下分发。