Kakao API MCP Server

カカオAPI MCPサーバー

カカオマップAPIとDaum検索APIをModel Context Protocol （MCP）を通じて活用できるサーバーです。このサーバーにより、AIモデルはカカオマップの地図関連機能とDaumのさまざまな検索機能を活用できます。

注意事項

• **カカオログイン、カカオトークメッセージの送信など、ユーザーアカウント関連の機能は含まれていません。**このサーバーは公開されたカカオとDaumのOpen APIのみを使用します。
• このサーバーを使用するには、有効なカカオREST APIキーが必要です。カカオデベロッパースでアプリを作成し、REST APIキーを発行してください。

主な機能

カカオマップAPI

1. 場所検索（ mcp_kakao_map_search_places ）
   • キーワードでカカオマップで場所を検索
   • 場所、カテゴリ、連絡先情報を提供
2. 座標 - アドレス変換（ mcp_kakao_map_coord_to_address ）
   • 経緯度座標を実アドレスに変換
   • 道路名住所及び地番住所情報の提供
3. ルートを探す（ mcp_kakao_map_find_route ）
   • 出発地から目的地までのルートを検索
   • 距離、所要時間、予想タクシー料金など提供
   • 交通状況情報を含む（オプション）

Daum Search API

1. Webドキュメント検索（ mcp_kakao_map_search_web ）
   • キーワードで次のウェブ文書を検索する
   • ページの並べ替えと検索結果の数を調整可能
2. 画像検索（ mcp_kakao_map_search_image ）
   • キーワードで次の画像を検索
   • 画像URLと関連情報を提供する
3. ブログ検索（ mcp_kakao_map_search_blog ）
   • キーワードで次のブログ記事を検索
   • ブログ名、投稿タイトル、コンテンツサマリーを提供
4. カフェ検索（ mcp_kakao_map_search_cafe ）
   • キーワードで次のカフェ投稿を検索
   • カフェ名、投稿タイトル、コンテンツサマリーを提供

ツール使用例(MCP)

以下は、MCPクライアント（AIモデルなど）がこのサーバーのツールを呼び出す方法と予想される応答形式です。

カカオマップAPI

1. 場所検索 ( mcp_kakao_map_search_places )

呼び出し（要求）：

応答（Response - 例）：

2. 座標 - アドレス変換 ( mcp_kakao_map_coord_to_address )

呼び出し（要求）：

応答（Response - 例）：

3.ルートを探す（ mcp_kakao_map_find_route ）

呼び出し（要求）：

応答（Response - 例）：

Daum Search API

1. Web文書検索（ mcp_kakao_map_search_web ）

呼び出し（要求）：

応答（Response - 例）：

2.画像検索（ mcp_kakao_map_search_image ）

呼び出し（要求）：

応答（Response - 例）：

3. ブログ検索 ( mcp_kakao_map_search_blog )

呼び出し（要求）：

応答（Response - 例）：

4. カフェ検索 ( mcp_kakao_map_search_cafe )

呼び出し（要求）：

応答（Response - 例）：

インストールと設定

1. ストレージの複製と依存関係のインストール：

• このプロジェクトでは、 yarnパッケージマネージャの使用をお勧めします。

2. カカオREST APIキー設定：
   • プロジェクトのルートディレクトリに.envファイルを作成します。
   • .envファイルに、次のようにカカオデベロッパーから発行されたREST APIキーを入力します。
     KAKAO_REST_API_KEY=여기에_카카오_REST_API_키_입력
   • あるいは、サーバーの実行時に--kakao-api-key引数を介して直接渡すこともできます。

実行方法

サーバーを実行する前にコードをビルドする必要があります。 start関連のスクリプトにはビルドプロセスが含まれているため、別々にyarn buildを実行する必要はありません。

HTTPモード(デフォルト)

他のサービスやツールとHTTP経由で通信するときに使用します。

デフォルトでは3000番ポートを使用します。ポートを変更するには、 --port引数を使用します。

stdioモード

端末の標準入出力（stdin/stdout）を介してMCPメッセージを送受信するときに使用します。

開発モード

開発中にコードが変更されたときに自動的にビルドしてサーバーを再起動するには（nodemonなどの別途設定が必要です）、 devスクリプトを利用できます。現在のdevスクリプトはstartと同じように動作します。

ライセンス

このプロジェクトはMITライセンスの下で展開されます。