Naver MCP 服务器

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

前提条件

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

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

安装

从 PyPi 安装 (Claude Desktop)

使用 (uv) 将其安装到 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)

使用 (uv) 将其安装到 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

# 导航到项目目录
cd py-mcp-naver

# 同步依赖项
uv sync --dev --all-extras

使用以下命令运行它：

# 启动服务器 (使用 FastMCP CLI)
fastmcp install mcp_naver/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 cafes 中的文章。
• 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 cafes 中的文章。

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 许可开源的软件。