【技术文档摘要】：

KiMCP (韩国集成模型上下文协议)

<p align="center"> <a href="README.en.md">🇺🇸 英文</a> | <a href="README.md">🇰🇷 韩文</a> </p>

KiMCP 是一个利用 模型上下文协议 (MCP) 的 MCP 服务器，允许在 LLM 应用程序中使用如 Naver、Kakao 和 TMAP 等国内 API。

<p align="center"> <img src="screenshots/screenshot-0.png" alt="截图 1" style="width: 80%; height: auto; margin-bottom: 15px;"> <img src="screenshots/screenshot-1.png" alt="截图 2" style="width: 80%; height: auto;"> </p>

功能

• Naver 博客搜索：从 Naver 搜索博客内容
• Naver 新闻搜索：从 Naver 搜索新闻文章
• Naver 社区搜索：从 Naver 社区搜索帖子
• Naver 知识iN 搜索：从 Naver 知识iN 搜索问答帖子
• Naver 地区搜索：搜索地区企业及地点信息
• Naver 图片搜索：从 Naver 搜索图片
• Naver 购物搜索：从 Naver 购物搜索商品及价格比较
• Daum 博客搜索：从 Daum 搜索博客内容
• Daum 社区搜索：从 Daum 社区搜索帖子
• Kakao 地图搜索：从 Kakao 地图搜索地点及企业信息
• 汽车导航：使用 Kakao 地图提供汽车导航信息
• 公共交通导航：使用 TMAP 提供公共交通导航信息

当前正在开发中...

先决条件

• Claude Desktop
• uv (Python 包管理器)
• Naver API Key
• Kakao API Key
• SK Open API Key

安装

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
   

   注意：

   • Naver API 密钥可以在 Naver 开发者中心 获取。
   • Kakao API 密钥可以在 Kakao Developers 获取。
   • TMAP (SK Open API) 密钥可以在 SK Open 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

发展路线图

• ✅ Naver API 集成
• ✅ Kakao API 集成
• ✅ SK Open API 集成
• ⬜ 气象厅 (KMA) 集成
• 其他等

许可证

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

致谢

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