Skip to main content
Glama
Sign In
kakao-mcp

kakao-mcp

by Sedong-Choi
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

kakao-mcp

카카오 API를 AI 에이전트에 연결하는 MCP 서버. 지도/로컬, 다음 검색, 비전 OCR을 REST API 키 하나로 바로 사용.

Kakao's Local (Map), Search, and Vision APIs as a Model Context Protocol server — Korea's location & content stack for Claude, Cursor, and any MCP client.

왜?

한국 앱·마케팅 개발에서 매일 필요한데(주소→좌표, 주변 장소, 국내 검색, 이미지 OCR) 깔끔한 MCP가 없었어요. 유저 OAuth 없이 REST 키 하나로 즉시 돌아갑니다.

Related MCP server: MCP Kakao Local

설치

npx kakao-mcp

REST API 키는 developers.kakao.com → 내 애플리케이션 → 앱 키 → REST API 키.

Claude Code / Claude Desktop

claude_desktop_config.json (또는 .mcp.json):

{
  "mcpServers": {
    "kakao": {
      "command": "npx",
      "args": ["-y", "kakao-mcp"],
      "env": { "KAKAO_REST_API_KEY": "your_rest_api_key" }
    }
  }
}

툴 (v0.1 · T1)

툴

설명

kakao_address_to_coord

주소 → 위경도 좌표 + 정규화 주소

kakao_search_place

키워드 장소 검색 (좌표+반경 주변검색 지원)

kakao_place_by_category

카테고리별 주변 장소 (카페·음식점·병원 등)

kakao_coord_to_address

좌표 → 도로명/지번 주소

kakao_coord_to_region

좌표 → 행정동/법정동

kakao_search

다음 검색: 웹/블로그/카페/이미지/동영상/책

kakao_ocr

이미지 URL에서 텍스트 추출 (OCR)

써보기

"판교역로 235 좌표 알려줘" "강남역 반경 500m 카페 5개 찾아줘" "이 좌표(127.02, 37.5) 무슨 동이야?" "블로그에서 '분당 브런치' 검색해줘"

로드맵

  • v0.2 (T2) — 카카오 로그인(OAuth) · 나에게 메시지 보내기(알림 훅)

  • v0.3 (T3) — 카카오톡 채널 · 알림톡/친구톡 · 카카오모먼트 광고

개발

npm install
npm run build
KAKAO_REST_API_KEY=... npm start

라이선스

MIT © Kioko Lab

Available Tools

6 tools
kakao_address_to_coordA

주소(도로명/지번)를 위경도 좌표로 변환하고 정규화된 주소를 반환. 예: '경기도 성남시 분당구 판교역로 235'.

Inputs: query (required).

kakao_coord_to_addressB

위경도 좌표를 도로명/지번 주소로 역변환. 예: x=127.1086, y=37.4012.

Inputs: x (required), y (required).

kakao_coord_to_regionB

위경도 좌표를 행정동/법정동 행정구역 정보로 변환.

Inputs: x (required), y (required).

kakao_place_by_categoryA

특정 카테고리의 장소를 좌표 주변에서 검색. 카테고리 코드 필수. MT1 대형마트, CS2 편의점, PS3 어린이집·유치원, SC4 학교, AC5 학원, PK6 주차장, OL7 주유소·충전소, SW8 지하철역, BK9 은행, CT1 문화시설, AG2 중개업소, PO3 공공기관, AT4 관광명소, AD5 숙박, FD6 음식점, CE7 카페, HP8 병원, PM9 약국

Inputs: x (required), y (required), radius (required), category_group_code (required), +2 more.

kakao_searchB

다음(Daum) 검색으로 웹/블로그/카페/이미지/동영상/책을 검색. 국내 콘텐츠·SEO 리서치에 유용.

Inputs: type (required), query (required), size, sort.

kakao_search_placeA

키워드로 장소를 검색. 좌표(x,y)+반경을 주면 주변 검색. 예: '강남역 카페', '판교 맛집'.

Inputs: query (required), x, y, size, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.7/5.0

    Scored across 6 tools

    Disambiguation4/5

    The coordinate conversion tools (address_to_coord, coord_to_region, coord_to_address) have clear but slightly overlapping purposes, while the place search tools are distinguished by keyword vs category. The general search tool is clearly separate from local services. Only coord_to_region and coord_to_address could occasionally be confused.

    Naming Consistency4/5

    All tools share the 'kakao_' prefix, and most follow a noun_to_noun or verb_noun pattern. However, 'place_by_category' and 'search' deviate from the conversion-oriented naming, making the set slightly inconsistent.

    Tool Count5/5

    With 6 tools, the server covers both local API operations (address/coord conversions, place search) and a general search API. This is a well-scoped set for a Kakao API wrapper, with no redundant or missing obvious tools.

    Completeness4/5

    The tool surface covers the primary Kakao Local API functions: forward/reverse geocoding, region lookup, and two types of place search. The general search tool handles web, blog, cafe, image, video, and book searches. Minor gaps exist (e.g., no direct region-to-coordinates lookup) but are workarounds.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    Related MCP Servers