<中文翻译> py-mcp-naver搜索
项目介绍
Naver 搜索 MCP 服务器
此 MCP（多平台通信协议）服务器提供了访问 Naver 搜索 API 的功能，允许 AI 代理在 Naver 上搜索各种类型的内容。
概述
- 搜索博客、新闻、书籍、图片、购物商品等
- 多个搜索类别支持分页
- 结构化文本响应，优化供 LLM 使用
- 检查成人内容
- 转换键盘输入错误（误输入）
目录
配置
先决条件
- Python 3.12+
- Naver 开发者 API 凭证
- 您可以通过注册 Naver 开发者 门户来获取这些凭证。
- 您也可以查看我的博客 Naver 搜索 API MCP 服务器。
安装
- 克隆仓库：
git clone https://github.com/jikime/py-mcp-naver-search.git
cd py-mcp-naver-search
- 安装 uv
curl -LsSf https://astral.sh/uv/install.sh | sh
- 创建虚拟环境并安装依赖项：
uv venv -p 3.12
source .venv/bin/activate
pip install -r requirements.txt
- 创建一个包含您的 Naver API 凭证的
.env文件：
cp env.example .env
vi .env
NAVER_CLIENT_ID=your_client_id_here
NAVER_CLIENT_SECRET=your_client_secret_here
使用 Docker
- 构建 Docker 镜像：
docker build -t py-mcp-naver-search .
- 运行容器：
docker run py-mcp-naver-search
使用本地
- 运行服务器：
mcp run server.py
- 运行 MCP Inspector
mcp dev server.py
配置 MCP 设置
将服务器配置添加到您的 MCP 设置文件中：
Claude 桌面应用
- 通过 Smithery 自动安装：
npx -y @smithery/cli install @jikime/py-mcp-naver-search --client claude
- 手动安装
打开
~/Library/Application Support/Claude/claude_desktop_config.json
向 mcpServers 对象添加以下内容：
{
"mcpServers": {
"Google Toolbox": {
"command": "/path/to/bin/uv",
"args": [
"--directory",
"/path/to/py-mcp-naver-search",
"run",
"server.py"
]
}
}
}
Cursor IDE
打开 ~/.cursor/mcp.json
向 mcpServers 对象添加以下内容：
{
"mcpServers": {
"Google Toolbox": {
"command": "/path/to/bin/uv",
"args": [
"--directory",
"/path/to/py-mcp-naver-search",
"run",
"server.py"
]
}
}
}
Docker
{
"mcpServers": {
"Google Toolbox": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"py-mcp-naver-search"
]
}
}
}
使用客户端
该仓库包括用于测试的客户端脚本：
# 基本搜索
uv run client.py blog "Python 编程" display=5 page=1
# 新闻搜索排序
uv run client.py news "AI" display=10 page=1 sort=date
# 图片搜索过滤
uv run client.py image "猫" display=10 filter=large
# 检查成人内容
uv run client.py adult "您的查询"
# 错误修正
uv run client.py errata "spdlqj"
支持的搜索类别
服务器支持以下搜索类别：
blog- 博客文章news- 新闻文章book- 书籍adult- 成人内容检查encyc- 百科全书条目cafe_article- 咖啡馆文章kin- 知识 iN 问答local- 当地企业信息errata- 键盘输入错误修正shop- 购物商品doc- 学术论文和文档image- 图片webkr- 网页文档
API 参考
工具
搜索博客
search_blog(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str
使用给定关键词在 Naver 上搜索博客。
搜索新闻
search_news(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str
使用给定关键词在 Naver 上搜索新闻。
搜索书籍
search_book(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str
使用给定关键词在 Naver 上搜索书籍信息。
检查成人查询
check_adult_query(query: str) -> str
确定输入查询是否是成人搜索词。
搜索百科全书
search_encyclopedia(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str
使用给定关键词在 Naver 上搜索百科全书信息。
搜索咖啡馆文章
search_cafe_article(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str
使用给定关键词在 Naver 上搜索咖啡馆文章。
搜索知识 iN
search_kin(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str
使用给定关键词在 Naver 上搜索知识 iN 问答。
搜索当地企业
search_local(query: str, display: int = 5, page: int = 1, sort: str = "random") -> str
使用给定关键词搜索当地企业信息。
修正误输入
correct_errata(query: str) -> str
转换韩语/英语键盘输入错误。
搜索购物商品
search_shop(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str
使用给定关键词在 Naver 上搜索购物产品信息。
搜索文档
search_doc(query: str, display: int = 10, page: int = 1) -> str
使用给定关键词搜索学术论文、报告等。
搜索图片
search_image(query: str, display: int = 10, page: int = 1, sort: str = "sim", filter: str = "all") -> str
使用给定关键词搜索图片。
搜索网页文档
search_webkr(query: str, display: int = 10, page: int = 1) -> str
使用给定关键词搜索网页文档。
资源
可用搜索类别
GET naver://available-search-categories
返回此 MCP 服务器上可用的 Naver 搜索类别列表。
响应格式
所有工具以结构化文本格式返回响应，优化供 LLM 使用：
Naver 博客搜索结果（总计 12,345 条，第 1~10 条）：
### 结果 1
标题(title): 示例博客文章
链接(link): https://blog.example.com/post1
描述(description): 这是一篇关于...的示例博客文章
博主姓名(bloggername): John Doe
博主链接(bloggerlink): https://blog.example.com
发布日期(postdate): 20250429
### 结果 2
...
致谢
许可证
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。