Naver MCP Server
Naver MCP 服务器
使用模型上下文协议 (MCP) 实现 Naver OpenAPI 的服务器。该项目提供与各种 Naver 服务交互的工具,例如搜索博客、新闻、书籍等。
快速概览
安装
# 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先决条件
要使用 Naver MCP 服务器,您需要申请访问 Naver Open API。您可以通过以下链接申请访问:
https://developers.naver.com/apps/#/register=datalab
跑步
使用以下命令运行它:
# Start the server (Using FastMCP CLI)
fastmcp install src/server.py -e NAVER_CLIENT_ID=<YOUR NAVER CLIENT ID> -e NAVER_CLIENT_SECRET=<YOUR NAVER CLIENT SECRET>该工具设置了创建与 Naver OpenAPI 集成的 MCP 服务器所需的一切。
Related MCP server: Naver Encyclopedia MCP Server
特征
该服务器提供以下与 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 许可的开源软件。
Available Tools
14 toolsadult_checkC
Check if the search term is adult content
Inputs: query (required).
fix_spellingC
Correct spelling errors in a given text
Inputs: query (required).
get_book_advD
Get book information from Naver
Inputs: sort, query, start, d_isbn, +2 more.
search_blogC
Search blog posts on Naver
Inputs: query (required), sort, start, display.
search_bookC
Search books on Naver
Inputs: query (required), sort, start, display.
search_cafe_articleC
Search cafe articles on Naver
Inputs: query (required), sort, start, display.
search_docC
Search documents on Naver
Inputs: query (required), start, display.
search_encycC
Search encyclopedia on Naver
Inputs: query (required), start, display.
search_imageC
Search images on Naver
Inputs: query (required), sort, start, filter, +1 more.
search_kinC
Search Q&A on Naver
Inputs: query (required), sort, start, display.
search_localC
Search local information on Naver
Inputs: query (required), sort, start, display.
search_newsC
Search news articles on Naver
Inputs: query (required), sort, start, display.
search_shopC
Search shopping items on Naver
Inputs: query (required), sort, start, filter, +2 more.
search_webkrC
Search web pages on Naver
Inputs: query (required), start, display.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Most tools are clearly separated by search domain (blog, news, book, image, shop, etc.), so an agent can usually pick the right one. Minor ambiguity exists between search_book and get_book_adv, and search_doc vs search_webkr may require interpretation.
The dominant pattern is search_<domain>, used consistently across most tools. A few utility/detail tools deviate (get_book_adv, adult_check, fix_spelling), but they remain readable and not chaotic.
14 tools is well within a reasonable range for a search-oriented MCP server. Each tool maps to a distinct Naver search category or small utility, so the count feels well-scoped.
The surface covers a broad set of Naver search domains plus adult-content checking and spelling correction. There are minor gaps such as limited detail-fetching beyond books and no obvious movie/other Naver search categories, but core search workflows are covered.
Related MCP Connectors
MCP server for real-time product search by barcode (EAN, UPC, GTIN) or keyword on ean-search.org
The Remote MCP server acts as a standardized bridge between LLM applications (like Claude, ChatGPT, and Cursor) and external services, enabling AI agents to access external tools and resources. Its primary capability is providing a centralized search tool to discover other MCP servers and their respective tools. Unlike local implementations, it runs remotely with OAuth authentication and permission controls for security.
MCP server for searching Airweave collections with natural language queries.
The Needle MCP server enables semantic search on documents stored in files like PDFs, DOCX, and XLSX by connecting AI applications to external data sources. It provides capabilities to create and manage document collections, perform natural language searches on stored content, and retrieve relevant information without requiring exact keyword matches.
Related MCP Servers
- AlicenseBqualityBmaintenanceAn MCP server that enables searching various content types (news, blogs, shopping, images, etc.) through Naver's search API.1989MIT
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that wraps Naver's encyclopedia search API, allowing users to search for information from Naver's encyclopedia through stdin/stdout or HTTP interfaces.-
- FlicenseAqualityCmaintenanceNaver Search API + Datalab API MCP server with 19 tools for Korean web search and trend analysis.19-
- AlicenseCqualityDmaintenance이 MCP 서버는 네이버 쇼핑인사이트 API와 검색 API를 통합하여 카테고리 및 키워드 트렌드를 조회하고 블로그, 쇼핑, 지식iN, 백과사전 검색을 수행할 수 있게 해줍니다.121ISC