🚀 Naver MCP 服务器
Naver MCP 服务器是一个借助模型上下文协议（MCP）实现的 Naver OpenAPI 服务器。它提供了一系列与 Naver 各类服务交互的工具，可用于搜索博客、新闻、书籍等内容，为开发者提供了便捷的服务调用途径。
🚀 快速开始
要使用 Naver MCP 服务器，您首先需要申请访问 Naver 开放 API。您可以通过以下链接进行注册申请：Naver 开放 API 注册
✨ 主要特性
该服务器具备多种实用工具，用于与 Naver 服务进行交互，主要功能如下：
- 博客搜索：通过
search_blog函数搜索 Naver 博客内容。 - 新闻搜索：使用
search_news查找相关新闻报道。 - 网页搜索：利用
search_webkr进行通用网页搜索。 - 图像搜索：通过
search_image搜索图片，并可设置过滤器。 - 购物搜索：使用
search_shop浏览商品信息，支持筛选功能。
📦 安装指南
通过 PyPi（Claude Desktop）
使用 Claude Desktop 安装
uv pip install mcp-naver
uv run python -m mcp-naver.hosts.claude_desktop \
-e NAVER_CLIENT_ID= \
-e NAVER_CLIENT_SECRET=
直接在 Claude Desktop 上运行
pip install mcp-naver
python -m mcp-naver.hosts.claude_desktop \
-e NAVER_CLIENT_ID= \
-e NAVER_CLIENT_SECRET=
通过 PyPi（Cursor）
在 Cursor 上安装：
uv pip install mcp-naver
uv run python -m mcp-naver.hosts.cursor \
-e NAVER_CLIENT_ID= \
-e NAVER_CLIENT_SECRET=
从源代码安装
# 克隆仓库
git clone https://github.com/pfldy2850/py-mcp-naver.git
# 安装依赖并运行
pip install -r requirements.txt
python main.py
💻 使用示例
基础用法
安装与配置
- 克隆仓库并安装依赖：
git clone https://github.com/pfldy2850/py-mcp-naver.git
cd py-mcp-naver
pip install -r requirements.txt
- 配置环境变量或直接在代码中设置 Naver API 的客户端 ID 和秘钥。
示例代码
from mcp_server import NaverMCP
# 初始化服务器实例
naver = NaverMCP(client_id="your_client_id", client_secret="your_client_secret")
# 搜索博客内容
blogs = naver.search_blog(query="Python开发")
print(blogs)
📚 详细文档
完整的 API 文档请参考项目仓库中的 docs 目录或访问官方网站。
📄 许可证
该项目是开源软件，采用 MIT 许可证。