Naver MCP 服务器

使用模型上下文协议（MCP）实现的Naver OpenAPI服务器。该项目提供了与各种Naver服务交互的工具，如搜索博客、新闻、书籍等。

快速概览

安装

# Clone the repository
git clone https://github.com/pfldy2850/py-mcp-naver.git

# Navigate into the project directory
cd py-mcp-naver

# Synchronize dependencies
uv sync --dev --all-extras

前提条件

要使用Naver MCP服务器，您需要申请访问Naver Open API。
您可以通过以下链接申请Open API访问权限：

https://developers.naver.com/apps/#/register=datalab

运行

运行命令如下：

# Start the server (Using FastMCP CLI)
fastmcp install src/server.py -e NAVER_CLIENT_ID=<YOUR NAVER CLIENT ID> -e NAVER_CLIENT_SECRET=<YOUR NAVER CLIENT SECRET>

该工具为您设置了一切所需，以创建一个与Naver OpenAPI集成的MCP服务器。

功能

此服务器提供了与Naver OpenAPI交互的以下工具：

• 博客搜索：在Naver上搜索博客文章。
• 新闻搜索：在Naver上搜索新闻文章。
• 书籍搜索：搜索书籍和高级书籍信息。
• 成人内容检查：检查搜索词是否为成人内容。
• 百科全书搜索：搜索百科条目。
• Cafe文章搜索：在Naver咖啡馆中搜索文章。
• Q&A搜索：在Naver上搜索问题和答案。
• 本地搜索：搜索本地信息。
• 拼写纠正：纠正文本中的拼写错误。
• 网页搜索：搜索网页。
• 图片搜索：使用过滤器搜索图片。
• 购物搜索：使用过滤器搜索商品。
• 文档搜索：搜索文档。

Naver MCP 工具

服务器中实现了以下工具：

博客搜索

在Naver上搜索博客文章。

search_blog(query: str, display: int = 10, start: int = 1, sort: str = "sim")

新闻搜索

在Naver上搜索新闻文章。

search_news(query: str, display: int = 10, start: int = 1, sort: str = "sim")

书籍搜索

在Naver上搜索书籍。

search_book(query: str, display: int = 10, start: int = 1, sort: str = "sim")

高级书籍搜索

通过标题或ISBN获取详细的书籍信息。

get_book_adv(query: str = None, d_titl: str = None, d_isbn: str = None, ...)

成人内容检查

检查搜索词是否为成人内容。

adult_check(query: str)

百科全书搜索

在Naver上搜索百科条目。

search_encyc(query: str, display: int = 10, start: int = 1)

Cafe文章搜索

在Naver咖啡馆中搜索文章。

search_cafe_article(query: str, display: int = 10, start: int = 1, sort: str = "sim")

Q&A搜索

在Naver上搜索问题和答案。

search_kin(query: str, display: int = 10, start: int = 1, sort: str = "sim")

本地搜索

在Naver上搜索本地信息。

search_local(query: str, display: int = 10, start: int = 1, sort: str = "random")

拼写纠正

纠正给定文本中的拼写错误。

fix_spelling(query: str)

网页搜索

在Naver上搜索网页。

search_webkr(query: str, display: int = 10, start: int = 1)

图片搜索

在Naver上使用过滤器搜索图片。

search_image(query: str, display: int = 10, start: int = 1, sort: str = "sim", filter: str = "all")

购物搜索

在Naver上使用过滤器搜索商品。

search_shop(query: str, display: int = 10, start: int = 1, sort: str = "sim", filter: str = None, exclude: str = None)

文档搜索

在Naver上搜索文档。

search_doc(query: str, display: int = 10, start: int = 1)

许可证

本项目是开源软件 采用MIT许可。