Naver MCP 服务器

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

预备条件

要使用Naver MCP服务器，您需要申请访问Naver OpenAPI。您可以在以下链接中申请OpenAPI访问：

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

安装

从PyPi安装（Claude Desktop）

在Claude Desktop上安装它（使用uv）：

uv pip install mcp-naver

uv run python -m mcp-naver.hosts.claude_desktop \
  -e NAVER_CLIENT_ID=<您的NAVER客户端ID> \
  -e NAVER_CLIENT_SECRET=<您的NAVER客户端密钥>

在Claude Desktop上安装它：

pip install mcp-naver

python -m mcp-naver.hosts.claude_desktop \
  -e NAVER_CLIENT_ID=<您的NAVER客户端ID> \
  -e NAVER_CLIENT_SECRET=<您的NAVER客户端密钥>

从PyPi安装（Cursor）

在Cursor上安装它（使用uv）：

uv pip install mcp-naver

uv run python -m mcp-naver.hosts.cursor \
  -e NAVER_CLIENT_ID=<您的NAVER客户端ID> \
  -e NAVER_CLIENT_SECRET=<您的NAVER客户端密钥>

从源代码安装

# 克隆仓库
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=<您的NAVER客户端ID> -e NAVER_CLIENT_SECRET=<您的NAVER客户端密钥>

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

功能

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

• 博客搜索：搜索Naver上的博客文章。
• 新闻搜索：搜索Naver上的新闻文章。
• 书籍搜索：搜索书籍及高级书籍信息。
• 成人内容检查：检查搜索词是否为成人内容。
• 百科全书搜索：搜索Naver上的百科全书条目。
• 咖啡馆文章搜索：搜索Naver咖啡馆中的文章。
• 问答搜索：搜索Naver上的问题和答案。
• 本地搜索：搜索Naver上的本地信息。
• 拼写纠正：纠正给定文本中的拼写错误。
• 网页搜索：搜索Naver上的网页。
• 图片搜索：使用过滤器搜索Naver上的图片。
• 购物搜索：使用过滤器搜索Naver上的购物商品。
• 文档搜索：搜索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)

咖啡馆文章搜索

搜索Naver咖啡馆中的文章。

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

问答搜索

搜索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许可证。