KiMCP (Korea-integrated Model Context Protocol)

KiMCP（韓国統合 Model Context Protocol）

🇺🇸 英語 | 🇰🇷 韓国語

KiMCPは、Model Context Protocol（MCP）を活用し、ネイバー、カカオ、TMAPなど、韓国国内のAPIをLLMアプリケーションで利用できるMCPサーバーです。

機能

• ネイバーブログ検索：ネイバーでブログコンテンツを検索
• ネイバーニュース検索：ネイバーでニュース記事を検索
• ネイバーカフェ検索：ネイバーのカフェコミュニティで投稿を検索
• ネイバー知識iN検索：ネイバー知識iNでQ&A投稿を検索
• ネイバー地域検索：地域の店舗や場所の情報を検索
• ネイバー画像検索：ネイバーで画像を検索
• ダウムブログ検索：ダウムのブログでブログコンテンツを検索
• ダウムカフェ検索：ダウムのカフェで投稿を検索
• カカオマップ検索：カカオマップで場所や店舗の情報を検索
• 自動車ルート検索：カカオマップを使って自動車のルート情報を提供
• 公共交通機関のルート検索：TMAPを使って公共交通機関のルート情報を提供

現在開発中…

前提条件

• Claude Desktop
• uv（Pythonパッケージマネージャー）
• 使用するサービスのAPIキー（ネイバー、カカオ、SK Open API）：APIキー発行ガイドを参照

インストール

1. リポジトリを複製

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

2. Pythonの依存関係をインストール

   uv sync
   

3. 環境変数を設定

   プロジェクトのルートにある.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のみを使用する場合は、該当するAPIキーのみを設定すれば大丈夫です。
     • APIキーが入力されていない場合、該当するMCPツールは自動的に無効になります。たとえば、ネイバーのAPIキーのみを入力し、カカオのAPIキーを入力しない場合、ネイバー関連のツールのみを使用できます。

4. Claude Desktopにインストール

   uv run mcp install main.py -f .env
   

5. 変更を適用するため、Claude Desktopを再起動

開発

テストと開発用にMCP inspectorを起動します：

uv run mcp dev main.py

テストを実行します：

uv run pytest

通常のテストでは実際のAPIを呼び出しません。すべてのツールを実際のAPIでテストするには、.envのキーを使って別途実行してください。キーが設定されていないAPIのツールはスキップされます。

uv run --env-file .env pytest -m live

ロードマップ

• ✅ ネイバーAPIの統合
• ✅ カカオAPIの統合
• ✅ SK Open APIの統合
• ⬜ 韓国気象庁（KMA）の統合
• その他

ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳しくはLICENSEファイルを参照してください。

謝辞

• py-mcp-naver
• MCP
• MCP Python SDK
• ネイバー開発者センター
• カカオ Developers
• TMAP
• Claude Desktop