Kakao Maps MCP server

This MCP server allows AI models to use Kakao Map API and Daum Search API through the Model Context Protocol. It provides access to map-related features and various search capabilities without requiring user account functionality.

Installation and Setup

Prerequisites

To use this server, you'll need a valid Kakao REST API key. You can obtain this key by creating an app on Kakao Developers.

Installation Steps

1. Clone the repository and install dependencies:

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

2. Configure your Kakao REST API key using one of these methods:

   • Create a .env file in the project root directory with:

     KAKAO_REST_API_KEY=your_kakao_rest_api_key_here
     

   • Or provide it directly when running the server using the --kakao-api-key argument

Running the Server

HTTP Mode (Default)

Use HTTP mode to communicate with other services or tools:

yarn start

By default, the server uses port 3000. To change the port:

yarn start --port 8080

stdio Mode

Use stdio mode to send and receive MCP messages through terminal standard input/output:

yarn start:stdio

Available API Functions

Kakao Map API

1. Place Search (mcp_kakao_map_search_places)

Search for places on Kakao Map using keywords.

Example Request:

{
  "tool_name": "mcp_kakao_map_search_places",
  "parameters": {
    "keyword": "판교역 현대백화점"
  }
}

Example Response:

{
  "tool_name": "mcp_kakao_map_search_places",
  "result": "장소 검색 결과 (결과 수: 15, 총 18개):\n이름: 현대백화점 판교점\n주소: 경기 성남시 분당구 백현동 541\n카테고리: 쇼핑,유통 > 백화점 > 현대백화점\n전화번호: 031-5170-2233\n상세정보: http://place.map.kakao.com/18757447\n---\n... (추가 결과)"
}

2. Coordinate to Address Conversion (mcp_kakao_map_coord_to_address)

Convert geographic coordinates to actual addresses.

Example Request:

{
  "tool_name": "mcp_kakao_map_coord_to_address",
  "parameters": {
    "x": 127.1120278,
    "y": 37.3955833
  }
}

Example Response:

{
  "tool_name": "mcp_kakao_map_coord_to_address",
  "result": "주소 변환 결과:\n도로명: 경기 성남시 분당구 판교역로146번길 20\n지번: 경기 성남시 분당구 백현동 535"
}

3. Route Finding (mcp_kakao_map_find_route)

Find routes between locations with distance, time, and taxi fare estimates.

Example Request:

{
  "tool_name": "mcp_kakao_map_find_route",
  "parameters": {
    "origin": "판교역",
    "destination": "정자역",
    "transportation_type": "car",
    "traffic_info": true
  }
}

Example Response:

{
  "tool_name": "mcp_kakao_map_find_route",
  "result": "🗺️ 길찾기 결과\n\n출발지: 판교역 신분당선 (경기 성남시 분당구 삼평동)\n\n목적지: 정자역 신분당선 (경기 성남시 분당구 정자동)\n\n이동 수단: 자동차\n\n총 거리: 3.6km\n예상 소요 시간: 10분\n예상 택시 요금: 5,600원\n\n📊 교통 상황 요약:\n\n카카오맵에서 보기: https://map.kakao.com/?sName=%ED%8C%90%EA%B5%90%EC%97%AD&eName=%EC%A0%95%EC%9E%90%EC%97%AD\n"
}

Daum Search API

1. Web Document Search (mcp_kakao_map_search_web)

Search for web documents using keywords.

Example Request:

{
  "tool_name": "mcp_kakao_map_search_web",
  "parameters": {
    "query": "카카오브레인 칼로",
    "size": 2
  }
}

2. Image Search (mcp_kakao_map_search_image)

Search for images using keywords.

Example Request:

{
  "tool_name": "mcp_kakao_map_search_image",
  "parameters": {
    "query": "고양이",
    "size": 1
  }
}

3. Blog Search (mcp_kakao_map_search_blog)

Search for blog posts using keywords.

Example Request:

{
  "tool_name": "mcp_kakao_map_search_blog",
  "parameters": {
    "query": "판교 맛집",
    "size": 1
  }
}

4. Cafe Search (mcp_kakao_map_search_cafe)

Search for cafe posts using keywords.

Example Request:

{
  "tool_name": "mcp_kakao_map_search_cafe",
  "parameters": {
    "query": "코딩 스터디",
    "size": 1
  }
}

How to add this MCP server to Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > MCP and click "Add new global MCP server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "cursor-rules-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cursor-rules-mcp"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.