Kakao API MCP Server

This is a server that can utilize Kakao Map API and Daum Search API through Model Context Protocol (MCP). Through this server, AI models can utilize Kakao Map's map-related functions and Daum's various search functions.

caution

• User account-related functions such as Kakao login, sending KakaoTalk messages, etc. are not included. This server only uses the public Kakao and Daum Open APIs.
• To use this server, you need a valid Kakao REST API key . Create an app at Kakao Developers and obtain a REST API key.

Key Features

Kakao Map API

1. Search places ( mcp_kakao_map_search_places )
   • Search for places on Kakao Map by keyword
   • Provide location, category, and contact information
2. Coordinate-to-address conversion ( mcp_kakao_map_coord_to_address )
   • Convert latitude and longitude coordinates to real addresses
   • Provide road name address and lot number address information
3. Finding directions ( mcp_kakao_map_find_route )
   • Search route from origin to destination
   • Provides distance, travel time, estimated taxi fare, etc.
   • Include traffic information (optional)

Daum Search API

1. Web document search ( mcp_kakao_map_search_web )
   • Search the following web documents by keyword
   • Ability to adjust page sorting and number of search results
2. Image search ( mcp_kakao_map_search_image )
   • Search next image by keyword
   • Provide image URL and related information
3. Blog Search ( mcp_kakao_map_search_blog )
   • Search the following blog posts by keyword
   • Provide blog name, post title, and content summary
4. Cafe Search ( mcp_kakao_map_search_cafe )
   • Search Daum Cafe articles by keyword
   • Provide cafe name, post title, and content summary

Example of tool usage (MCP)

Below is how an MCP client (e.g. an AI model) calls a tool on this server and the expected response format.

Kakao Map API

1. Search for places ( mcp_kakao_map_search_places )

Request:

Response (Example):

2. Coordinate-to-address conversion ( mcp_kakao_map_coord_to_address )

Request:

Response (Example):

3. Finding directions ( mcp_kakao_map_find_route )

Request:

Response (Example):

Daum Search API

1. Web document search ( mcp_kakao_map_search_web )

Request:

Response (Example):

2. Image search ( mcp_kakao_map_search_image )

Request:

Response (Example):

3. Blog search ( mcp_kakao_map_search_blog )

Request:

Response (Example):

4. Cafe Search ( mcp_kakao_map_search_cafe )

Request:

Response (Example):

Installation and setup

1. Clone the repository and install dependencies:

• This project recommends using the yarn package manager.

2. Setting up Kakao REST API Key:
   • Create a .env file in your project root directory.
   • Enter the REST API key issued by Kakao Developers in .env file as follows:
     KAKAO_REST_API_KEY=여기에_카카오_REST_API_키_입력
   • Alternatively, you can pass it directly via --kakao-api-key argument when running the server.

How to run

You need to build your code before running the server. The build process is included in the start script, so you don't need to run yarn build separately.

HTTP mode (default)

Used when communicating with other services or tools via HTTP.

By default it uses port 3000. To change the port, use --port argument:

stdio mode

Used to send and receive MCP messages through the terminal's standard input/output (stdin/stdout).

Development mode

If you want to automatically build and restart the server when the code changes during development (requires separate settings such as nodemon), you can use the dev script. Currently, dev script works the same as start .

License

This project is distributed under the MIT License.