https://github.com/yunkee-lee/mcp-kakao-local
https://github.com/yunkee-lee/mcp-kakao-local
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/yunkee-lee/mcp-kakao-local
- Owner: yunkee-lee
- License: mit
- Created: 2025-05-04T22:07:00.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-05-04T22:26:26.000Z (5 months ago)
- Last Synced: 2025-05-04T23:24:21.303Z (5 months ago)
- Language: Python
- Size: 13.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# MCP Kakao Local
The MCP connects to the [Kakao Local API](https://developers.kakao.com/docs/latest/ko/local/common) and Kakao Map.
카카오 로컬 API 및 카카오맵에 연결하는 MCP 서버.
## Prerequisites
Before you begin, ensure you have the following installed:
* **Python:** Version 3.13 or higher
* **uv:** You can find installation instructions [here](https://github.com/astral-sh/uv).
* **Kakao Developers:** You need API credentials from the [Kakao developers](https://developers.kakao.com/).
## Configuration
1. **Create a `.env` file:** Create a file in the project root.
2. **Add API Credentials:** Edit the `.env` file and add your Kakao REST API credentials.
```.env
REST_API_KEY="YOUR_REST_API_KEY_HERE"
```
Please verify the exact environment variable names required by checking `src/mcp_kakao_local/kakao_local_client.py`.
## Running the MCP
1. **Sync Dependencies:** Navigate to the project root directory in your terminal and run the following command. This will create a virtual environment (if one doesn't exist) and install all dependencies specified in `pyproject.toml`.
```bash
uv sync
```
2. **Run:**: You can run the MCP server using `uv`.
```bash
uv run src/mcp_kakao_local
```
For development,
```bash
source .venv/bin/activate
mcp dev src/mcp_kakao_local/server.py
```