JinDaGe - Naver OpenAPI MCP Details

article

README

🚀 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=<YOUR NAVER CLIENT ID> \
  -e NAVER_CLIENT_SECRET=<YOUR NAVER CLIENT SECRET>

直接在 Claude Desktop 上运行

pip install mcp-naver

python -m mcp-naver.hosts.claude_desktop \
  -e NAVER_CLIENT_ID=<YOUR NAVER CLIENT ID> \
  -e NAVER_CLIENT_SECRET=<YOUR NAVER CLIENT SECRET>

通过 PyPi（Cursor）

在 Cursor 上安装：

uv pip install mcp-naver

uv run python -m mcp-naver.hosts.cursor \
  -e NAVER_CLIENT_ID=<YOUR NAVER CLIENT ID> \
  -e NAVER_CLIENT_SECRET=<YOUR 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 许可证。

Naver OpenAPI