基本能力
产品定位
Naver MCP Server 是一个用于与Naver OpenAPI交互的服务器实现，提供多种搜索和内容生成工具。
核心功能
- 博客搜索：搜索Naver上的博客文章。
- 新闻搜索：搜索Naver上的新闻文章。
- 书籍搜索：搜索书籍和高级书籍信息。
- 成人内容检查：检查搜索词是否为成人内容。
- 百科全书搜索：搜索百科全书条目。
- 咖啡馆文章搜索：搜索Naver咖啡馆中的文章。
- 问答搜索：搜索Naver上的问题和答案。
- 本地搜索：搜索本地信息。
- 拼写纠正：纠正文本中的拼写错误。
- 网页搜索：搜索网页。
- 图片搜索：搜索带有过滤器的图片。
- 购物搜索：搜索带有过滤器的购物商品。
- 文档搜索：搜索文档。
适用场景
- 需要从Naver获取多种类型内容的开发者。
- 需要集成Naver搜索功能的应用程序。
- 需要检查内容是否为成人内容的应用。
- 需要纠正拼写错误的应用。
工具列表
- Blog Search：搜索Naver上的博客文章。
- News Search：搜索Naver上的新闻文章。
- Book Search：搜索Naver上的书籍。
- Advanced Book Search：使用标题或ISBN获取详细的书籍信息。
- Adult Content Check：检查搜索词是否为成人内容。
- Encyclopedia Search：搜索百科全书条目。
- Cafe Article Search：搜索Naver咖啡馆中的文章。
- Q&A Search：搜索Naver上的问题和答案。
- Local Search：搜索本地信息。
- Spelling Correction：纠正文本中的拼写错误。
- Web Search：搜索网页。
- Image Search：搜索带有过滤器的图片。
- Shopping Search：搜索带有过滤器的购物商品。
- Document Search：搜索文档。
常见问题解答
- 需要申请Naver OpenAPI访问权限才能使用该服务。
使用教程
使用依赖
- 申请Naver OpenAPI访问权限：
- 访问 Naver OpenAPI注册页面 申请访问权限。
安装教程
从PyPi安装（Claude Desktop）
使用uv安装：
```sh
uv pip install mcp-naver
uv run python -m mcp-naver.hosts.claude_desktop \
-e NAVER_CLIENT_ID=
-e NAVER_CLIENT_SECRET=
```
使用pip安装：
```sh
pip install mcp-naver
python -m mcp-naver.hosts.claude_desktop \
-e NAVER_CLIENT_ID=
-e NAVER_CLIENT_SECRET=
```
从PyPi安装（Cursor）
使用uv安装：
```sh
uv pip install mcp-naver
uv run python -m mcp-naver.hosts.cursor \
-e NAVER_CLIENT_ID=
-e NAVER_CLIENT_SECRET=
```
从源代码安装
```sh
克隆仓库
git clone https://github.com/pfldy2850/py-mcp-naver.git
进入项目目录
cd py-mcp-naver
同步依赖
uv sync --dev --all-extras
```
运行：
```sh
启动服务器（使用FastMCP CLI）
fastmcp install mcp_naver/server.py -e NAVER_CLIENT_ID=
```
调试方式
安装完成后，可以通过运行相应的工具命令来测试功能是否正常工作。例如：
sh
python -m mcp-naver.hosts.claude_desktop \
-e NAVER_CLIENT_ID=<YOUR NAVER CLIENT ID> \
-e NAVER_CLIENT_SECRET=<YOUR NAVER CLIENT SECRET>
