Kakao API MCP 服务器
这是一个可以通过模型上下文协议（MCP）利用Kakao Map API和Daum Search API的服务器。该服务器允许AI模型利用Kakao Map的地图相关功能和Daum的各种搜索功能。
警告
**不包括与用户帐户相关的功能，例如 Kakao 登录和发送 KakaoTalk 消息。**该服务器仅使用Kakao和Daum的公共API。
使用此服务器需要有效的Kakao REST API 密钥。在Kakao Developers创建一个应用程序并获取 REST API 密钥。
Related MCP server: Playwright MCP Server
主要特点
Kakao地图API
搜索地点（
在 Kakao 地图上按关键字搜索地点
提供位置、类别和联系信息
坐标到地址的转换（
将经纬度坐标转换为真实地址
提供道路名称地址和地段号码地址信息
查找路线（
搜索从出发地到目的地的路线
提供距离、旅行时间、预计出租车费用等。
包含交通信息（可选）
Daum 搜索 API
网页文档搜索（
通过关键字搜索以下网络文档
能够调整页面排序和搜索结果数量
图片搜索（
按关键字搜索下一张图片
提供图片URL及相关信息
博客搜索（
按关键字搜索以下博客文章
提供博客名称、文章标题和内容摘要
咖啡馆搜索（
通过关键字搜索 Daum Cafe 文章
提供咖啡馆名称、帖子标题和内容摘要
工具使用示例（MCP）
以下是 MCP 客户端（例如 AI 模型）如何调用此服务器上的工具以及预期的响应格式。
Kakao地图API
1. 搜索地点（ mcp_kakao_map_search_places ）
要求：
{
"tool_name": "mcp_kakao_map_search_places",
"parameters": {
"keyword": "판교역 현대백화점"
}
}
响应（示例）：
{
"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
}
}
响应（示例）：
{
"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
}
}
响应（示例）：
{
"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. 网页文档搜索（ mcp_kakao_map_search_web ）
要求：
{
"tool_name": "mcp_kakao_map_search_web",
"parameters": {
"query": "카카오브레인 칼로",
"size": 2
}
}
响应（示例）：
{
"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
}
}
响应（示例）：
{
"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
}
}
响应（示例）：
{
"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. 咖啡厅搜索 ( mcp_kakao_map_search_cafe )
要求：
{
"tool_name": "mcp_kakao_map_search_cafe",
"parameters": {
"query": "코딩 스터디",
"size": 1
}
}
响应（示例）：
{
"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 Developers 颁发的 REST API 密钥，如下所示：KAKAO_REST_API_KEY=여기에_카카오_REST_API_키_입력或者，您可以在运行服务器时通过
--kakao-api-key参数直接传递它。
如何运行
您需要在运行服务器之前构建代码。不需要单独运行yarn build ，因为构建过程包含在start相关的脚本中。
HTTP 模式（默认）
通过 HTTP 与其他服务或工具通信时使用。
yarn start
默认情况下使用端口号 3000。要更改端口，请使用--port参数：
yarn start --port 8080
标准输入输出模式
用于通过终端的标准输入/输出（stdin/stdout）发送和接收 MCP 消息。
yarn start:stdio
开发模式
如果希望在开发过程中代码发生变更时自动构建并重启服务器（需要单独设置如nodemon），可以使用dev脚本。目前， dev脚本的行为与start相同。
yarn dev
执照
该项目根据 MIT 许可证分发。