KiMCP (Korea-integrated Model Context Protocol)

KiMCP（Korea-integrated Model Context Protocol）

🇺🇸 英语 | 🇰🇷 韩语

KiMCP 是一款 MCP 服务，通过 Model Context Protocol (MCP)，让大模型应用能够使用 NAVER、Kakao 和 TMAP 等韩国本地 API。

功能

• NAVER 博客搜索：搜索 NAVER 博客内容
• NAVER 新闻搜索：搜索 NAVER 新闻文章
• NAVER 咖啡馆搜索：搜索 NAVER 咖啡馆社区中的帖子
• NAVER 知识 iN 搜索：搜索 NAVER 知识 iN 中的问答帖子
• NAVER 本地搜索：搜索本地商家和地点信息
• NAVER 图片搜索：搜索 NAVER 图片
• Daum 博客搜索：搜索 Daum 博客内容
• Daum 咖啡馆搜索：搜索 Daum 咖啡馆中的帖子
• Kakao 地图搜索：搜索 Kakao 地图中的地点和商家信息
• 驾车路线规划：使用 Kakao 地图提供驾车路线信息
• 公共交通路线规划：使用 TMAP 提供公共交通路线信息

目前正在开发中……

前置条件

• Claude Desktop
• uv（Python 包管理器）
• 要使用的服务的 API 密钥（NAVER、Kakao、SK Open API）：请参阅 API 密钥获取指南

安装

1. 克隆仓库

   git clone https://github.com/zeikar/kimcp
   cd kimcp
   

2. 安装 Python 依赖项

   uv sync
   

3. 设置环境变量

   参考项目根目录提供的 .env.example 文件，创建 .env 文件：

   # .env.example 파일을 .env로 복사
   cp .env.example .env
   
   # 생성된 .env 파일 편집
   vi .env   # 또는 원하는 텍스트 에디터 사용
   

   在 .env 文件中按如下格式填写 API 密钥：

   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
   

   注意：

   • 各服务密钥的获取方法请参阅 API 密钥获取指南。
   • 如果只使用所需的 API，只需设置对应的 API 密钥。
     • 如果未填写 API 密钥，对应的 MCP 工具将自动停用。例如，只填写 NAVER API 密钥而不填写 Kakao API 密钥时，只能使用 NAVER 相关工具。

4. 安装到 Claude Desktop

   uv run mcp install main.py -f .env
   

5. 重启 Claude Desktop 以应用更改

开发

运行 MCP inspector 以进行测试和开发：

uv run mcp dev main.py

运行测试：

uv run pytest

默认测试不会调用真实 API。若要使用真实 API 调用所有工具，请使用 .env 中的密钥单独运行测试。没有密钥的 API 对应的工具将被跳过。

uv run --env-file .env pytest -m live

路线图

• ✅ 集成 NAVER API
• ✅ 集成 Kakao API
• ✅ 集成 SK Open API
• ⬜ 集成韩国气象厅（KMA）
• 其他等

许可证

本项目遵循 MIT 许可证。详情请参阅 LICENSE 文件。

致谢

• py-mcp-naver
• MCP
• MCP Python SDK
• NAVER 开发者中心
• Kakao Developers
• TMAP
• Claude Desktop