Naver OpenAPI

🚀 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

💻 使用示例

基礎用法

安裝與配置

1. 克隆倉庫並安裝依賴：

git clone https://github.com/pfldy2850/py-mcp-naver.git
cd py-mcp-naver
pip install -r requirements.txt

2. 配置環境變量或直接在代碼中設置 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 許可證。