Kakao Local

MCP connects to the Kakao Local API and Kakao Map. 카카오 로컬 API 및 카카오맵에 연결하는 MCP 서버.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "yunkee-lee-mcp-kakao-local": {
      "command": "uv",
      "args": [
        "run",
        "src/mcp_kakao_local"
      ],
      "env": {
        "REST_API_KEY": "YOUR_REST_API_KEY_HERE"
      }
    }
  }
}

The MCP Kakao Local server connects to Kakao Local API and Kakao Map to fetch location data and map information for your applications. It enables you to query local points of interest and map coordinates through a simple MCP interface, incorporating Kakao services into your data flows.

How to use

You run the MCP Kakao Local server locally and interact with it through an MCP client. Start the server, then issue requests to retrieve Kakao Local data such as places, geocoding, and map-based results. The server uses your Kakao REST API credentials to access the Kakao Local APIs securely.

Common usage patterns include starting the server in a local development environment, refreshing credentials when needed, and routing responses from Kakao Local to your application logic. Ensure your client is configured to communicate with the MCP URL or local stdio endpoint as supported by your client tooling.

How to install

Prerequisites you need to install before you start: Python 3.13 or higher, the MCP CLI tool uv, and Kakao Developers API credentials.

uv sync

uv run src/mcp_kakao_local

source .venv/bin/activate
mcp dev src/mcp_kakao_local/server.py

Additional configuration and notes

Create a .env file at the project root to store your Kakao API credentials. Put your REST API key in the following variable: REST_API_KEY. Make sure the exact environment variable names match what the local client expects.

REST_API_KEY="YOUR_REST_API_KEY_HERE"

Available tools

uv sync

Synchronizes dependencies and sets up the Python virtual environment, installing dependencies from pyproject.toml and preparing the runtime for the MCP server.

uv run

Starts the MCP server in the current project using the MCP CLI, targeting the Kakao Local MCP module.

source venv

Activates the Python virtual environment created for the MCP project.

mcp dev

Runs the MCP development command to start the local Kakao Local MCP server from server.py for iterative development.