kakao-api

이 MCP 서버는 카카오맵 API와 Daum 검색 API를 통해 AI 모델이 지도 기능과 검색 기능을 쉽게 활용하도록 제공합니다. 서버는 공개적으로 제공되는 Kakao Open API를 사용하며, 별도의 사용자 계정 기능은 포함되어 있지 않습니다. 모델은 mcp_kakao_map_search_places, mcp_kakao_map_coord_to_address, mcp_kakao_map_find_route 같은 카카오맵 도구와 mcp_kakao_map_search_web, mcp_kakao_map_search_image, mcp_kakao_map_search_blog, mcp_kakao_map_search_cafe 같은 Daum 검색 도구를 호출해 결과를 받아올 수 있습니다. 각 도구는 명확한 입력 파라미터를 받으며, 응답은 도구 이름과 결과를 포함하는 구조를 따릅니다. 이를 통해 모델은 특정 위치 검색, 좌표 변환, 경로 탐색, 웹/이미지/블로그/카페 검색 결과를 활용해 사용자질문에 대한 풍부한 응답을 구성할 수 있습니다.

사전 준비

• Node.js가 설치되어 있어야 합니다(권장 버전: LTS). 직원/개발 환경에 Yarn을 사용하는 것을 권장합니다.

설치 및 설정 단계

1. 저장소 복제

git clone https://github.com/yousleepwhen/kakao-api-mcp-server.git
cd kakao-api-mcp-server

2. 의존성 설치

yarn install

3. Kakao REST API 키 설정

• 프로젝트 루트에 .env 파일을 생성하거나, 실행 시 --kakao-api-key 인자를 사용합니다.
• 예시 .env:

KAKAO_REST_API_KEY=여기에_카카오_REST_API_키_입력

4. 서버 실행

• 기본 HTTP 포트(3000)에서 실행:

yarn start

• 포트를 변경하려면 인자에 --port를 사용합니다:

yarn start --port 8080

• stdio 모드로 MCP 메시지를 주고받으려면:

yarn start:stdio

참고: 카카오 REST API 키를 안전하게 관리해야 하며, .env 파일은 버전 관리에서 제외하는 것을 권장합니다.

일부 기능은 카카오 로그인 등 사용자 계정 권한이 필요한 기능을 포함하지 않습니다. Kakao REST API 키는 Kakao Developers에서 발급받아 사용하며, API 키 무단 노출을 피하기 위해 환경 변수나 비밀 관리 도구를 사용하십시오. 기본 포트는 3000이고, 필요 시 --port로 변경 가능합니다. 개발 중에는 환경 변수로 키를 주입하거나 실행 스크립트에 기본 키를 포함시키지 마십시오. MCP 도구 호출 예시는 README의 예시를 참조해 모델이 tool_name과 parameters 필드를 올바르게 구성하도록 합니다.