AI导哈

Naver API服务器

一个基于模型上下文协议(MCP)的Naver开放API服务器实现，提供博客、新闻、图书等多种Naver服务的搜索功能。

  • by pfldy2850
  • Python
  • 本地部署
  • 115 星标
  • 更新于
在 GitHub 查看 pfldy2850/py-mcp-naver

使用说明

Naver MCP服务器

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

先决条件

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

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

安装

来自PyPi（克劳德桌面）

使用（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（光标）

使用（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>

来源

# 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

运行它：

# Start the server (Using 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上搜索新闻文章。
  • 图书搜索：搜索书籍和高级书籍信息。
  • 成人内容检查：检查搜索词是否为成人内容。
  • 百科全书搜索：搜索百科全书条目。
  • 咖啡馆文章搜索：在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许可.

相关 MCP