https://github.com/zeikar/kimcp
MCP server enabling LLMs to use Korean APIs (Naver, Kakao, etc.)
https://github.com/zeikar/kimcp
claude kakao kakao-api mcp mcp-server model-context-protocol naver naver-api tmap
Last synced: 27 days ago
JSON representation
MCP server enabling LLMs to use Korean APIs (Naver, Kakao, etc.)
- Host: GitHub
- URL: https://github.com/zeikar/kimcp
- Owner: zeikar
- License: mit
- Created: 2025-04-02T10:33:32.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-05-15T11:41:02.000Z (6 months ago)
- Last Synced: 2025-09-11T05:49:52.948Z (about 2 months ago)
- Topics: claude, kakao, kakao-api, mcp, mcp-server, model-context-protocol, naver, naver-api, tmap
- Language: Python
- Homepage:
- Size: 1.19 MB
- Stars: 4
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.en.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - **kimcp** - MCP server enabling LLMs to use Korean APIs (Naver, Kakao, etc.) `python` `claude` `kakao` `kakao-api` `mcp` `pip install git+https://github.com/zeikar/kimcp` (🤖 AI/ML)
- awesome-mcp-servers - **kimcp** - MCP server enabling LLMs to use Korean APIs (Naver, Kakao, etc.) `python` `claude` `kakao` `kakao-api` `mcp` `pip install git+https://github.com/zeikar/kimcp` (AI/ML)
README
# KiMCP (Korea-integrated Model Context Protocol)
[](https://opensource.org/licenses/MIT)
KiMCP is a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) server that enables the use of Korean APIs—such as [Naver](http://www.naver.com/), [Kakao](https://www.kakaocorp.com/), and [TMAP](https://www.tmapmobility.com/)—in LLM applications.
## Features
- **Naver Blog Search**: Search and retrieve blog content from Naver
- **Naver News Search**: Search for news articles from Naver
- **Naver Cafe Search**: Find articles from Naver Cafe communities
- **Naver Knowledge iN Search**: Search Q&A articles from Naver Knowledge iN
- **Naver Local Search**: Find information about local businesses and places
- **Naver Image Search**: Search for images on Naver
- **Naver Shopping Search**: Find products and compare prices on Naver Shopping
- **Daum Blog Search**: Search and retrieve blog content from Daum
- **Daum Cafe Search**: Find articles from Daum Cafe communities
- **Kakao Map Search**: Search for places and business information on Kakao Map
- **Car Navigation**: Provide car navigation information using Kakao Map
- **Transit Navigation**: Provide public transportation navigation information using TMAP
More features in development...
## Prerequisites
- [Claude Desktop](https://claude.ai/download)
- [uv](https://docs.astral.sh/uv/getting-started/installation/) (Python Package Manager)
- [Naver API Key](https://developers.naver.com/apps/#/register)
- [Kakao API Key](https://developers.kakao.com/console/app)
- [SK Open API Key](https://openapi.sk.com/)
## Installation
1. **Clone the repository**
```bash
git clone https://github.com/zeikar/kimcp
cd kimcp
```
2. **Install dependencies**
```bash
uv sync
```
3. **Set up environment variables**
Create a `.env` file in the project root by referencing the provided `.env.example` file:
```bash
# Copy the .env.example file to .env
cp .env.example .env
# Edit the created .env file
vi .env # Or use your preferred text editor
```
Enter your API keys in the `.env` file as follows:
```
NAVER_CLIENT_ID=your_naver_client_id
NAVER_CLIENT_SECRET=your_naver_client_secret
KAKAO_REST_API_KEY=your_kakao_rest_api_key
SK_APP_KEY=your_sk_app_key
```
> **Note**:
>
> - You can obtain Naver API keys from the [Naver Developer Center](https://developers.naver.com/apps/#/register).
> - You can obtain Kakao API keys from [Kakao Developers](https://developers.kakao.com/console/app).
> - You can obtain SK Open API keys from [SK Open API](https://openapi.sk.com/).
> - If you only need to use certain APIs, you only need to set up the corresponding API keys.
> - MCP tools will be automatically disabled if their API keys are not provided. For example, if you only provide Naver API keys and not Kakao API keys, only Naver-related tools will be available.
4. **Install to Claude Desktop**
```bash
uv run mcp install main.py -f .env
```
5. **Restart Claude Desktop** to apply changes
## Development
Run the MCP inspector for testing and development:
```bash
uv run mcp dev main.py
```
## Roadmap
- ✅ Naver API integration
- ✅ Kakao API integration
- ✅ SK Open API integration
- ⬜ Korea Meteorological Administration (KMA) integration
- And more...
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
## Acknowledgements
- [py-mcp-naver](https://github.com/pfldy2850/py-mcp-naver)
- [MCP](https://modelcontextprotocol.io/introduction)
- [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk)
- [Naver Developers](https://developers.naver.com/main)
- [Kakao Developers](https://developers.kakao.com/)
- [TMAP](https://www.tmapmobility.com/)
- [Claude Desktop](https://claude.ai/download)