KiMCP (Korea-integrated Model Context Protocol)

By zeikar GitHub

MCP server enabling LLMs to use Korean APIs (Naver, Kakao, etc.)

mcp naver

Overview

What is KiMCP?

KiMCP (Korea-integrated Model Context Protocol) is a server implementation of the Model Context Protocol (MCP) that integrates various Korean APIs into large language model (LLM) applications.

How to use KiMCP?

To use KiMCP, clone the repository from GitHub, install the necessary dependencies, configure your Naver API credentials, and run the MCP server on Claude Desktop.

Key features of KiMCP?

Naver Blog Search: Retrieve blog content from Naver.
Naver News Search: Access news articles from Naver.
Naver Cafe Search: Find articles from Naver Cafe communities.
Naver Knowledge iN Search: Search Q&A articles from Naver Knowledge iN.
Naver Local Search: Get information about local businesses and places.
Naver Image Search: Search for images on Naver.
Naver Shopping Search: Find products and compare prices on Naver Shopping.

Use cases of KiMCP?

Integrating Korean content into AI applications.
Enhancing LLMs with localized search capabilities.
Developing applications that require access to Naver's extensive data.

FAQ from KiMCP?

What are the prerequisites for using KiMCP?

You need Claude Desktop, the uv Python Package Manager, and Naver API credentials.

Is KiMCP free to use?

Yes, KiMCP is open-source and free to use under the MIT License.

What is the roadmap for KiMCP?

Future integrations include Kakao API and Korea Meteorological Administration (KMA) integration.

Content

KiMCP (Korea-integrated Model Context Protocol)

🇺🇸 English | 🇰🇷 한국어

KiMCP는 Model Context Protocol (MCP)를 활용하여 네이버, 카카오, TMAP과 같은 국내 API들을 LLM 애플리케이션에서 사용할 수 있는 MCP 서버입니다.

스크린샷 1 스크린샷 2

Features

네이버 블로그 검색: 네이버에서 블로그 콘텐츠 검색
네이버 뉴스 검색: 네이버에서 뉴스 기사 검색
네이버 카페 검색: 네이버 카페 커뮤니티에서 게시물 검색
네이버 지식iN 검색: 네이버 지식iN에서 Q&A 게시물 검색
네이버 지역 검색: 지역 업체 및 장소 정보 검색
네이버 이미지 검색: 네이버에서 이미지 검색
네이버 쇼핑 검색: 네이버 쇼핑에서 상품 검색 및 가격 비교
다음 블로그 검색: 다음 블로그에서 블로그 콘텐츠 검색
다음 카페 검색: 다음 카페에서 게시물 검색
카카오맵 검색: 카카오맵에서 장소 및 업체 정보 검색
자동차 길찾기: 카카오맵을 사용하여 자동차 길찾기 정보 제공
대중교통 길찾기: TMAP을 사용하여 대중교통 길찾기 정보 제공

현재 개발 중...

Prerequisites

Installation

저장소 복제

git clone https://github.com/zeikar/kimcp
cd kimcp

Python 의존성 설치
```
uv sync
```
환경 변수 설정

프로젝트 루트에 제공된 .env.example 파일을 참고하여 .env 파일을 생성하세요:
```
# .env.example 파일을 .env로 복사
cp .env.example .env

# 생성된 .env 파일 편집
vi .env   # 또는 원하는 텍스트 에디터 사용
```
.env 파일에 다음과 같이 API 키를 입력하세요:
```
NAVER_CLIENT_ID=your_naver_client_id
NAVER_CLIENT_SECRET=your_naver_client_secret
KAKAO_REST_API_KEY=your_kakao_rest_api_key
SK_APP_KEY=your_sk_app_key
```
참고:
- 네이버 API 키는 네이버 개발자 센터에서 발급 받을 수 있습니다.
- 카카오 API 키는 카카오 Developers에서 발급 받을 수 있습니다.
- TMAP (SK Open API) 키는 SK Open API에서 발급 받을 수 있습니다.
- 필요한 API만 사용하는 경우, 해당 API 키만 설정해도 됩니다.
  - API 키를 입력하지 않으면 해당 MCP 도구가 자동으로 비활성화됩니다. 예를 들어, 네이버 API 키만 입력하고 카카오 API 키를 입력하지 않으면 네이버 관련 도구만 사용 가능합니다.
Claude Desktop에 설치
```
uv run mcp install main.py -f .env
```
변경 사항을 적용하려면 Claude Desktop 재시작