Naver MCP Server
ネイバー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へのアクセスを申請する必要があります。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上のニュース記事を検索します。
書籍検索: 書籍の検索と詳細な書籍情報。
アダルトコンテンツチェック: 検索語がアダルトコンテンツであるかどうかを確認します。
百科事典検索:百科事典の項目を検索します。
カフェ記事検索:ネイバーカフェ内の記事を検索します。
Q&A検索:Naver上の質問と回答を検索します。
ローカル検索:ローカル情報を検索します。
スペル修正: テキスト内のスペルの誤りを修正します。
Web 検索: Web ページを検索します。
画像検索: フィルターを使用して画像を検索します。
ショッピング検索: フィルターを使用してショッピングアイテムを検索します。
ドキュメント検索: ドキュメントを検索します。
ネイバーMCPツール
サーバーには次のツールが実装されています。
ブログ検索
Naverでブログ記事を検索します。
search_blog(query: str, display: int = 10, start: int = 1, sort: str = "sim")ニュース検索
ネイバーでニュース記事を検索します。
search_news(query: str, display: int = 10, start: int = 1, sort: str = "sim")書籍検索
ネイバーで本を検索します。
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)カフェ記事検索
ネイバーカフェ内の記事を検索します。
search_cafe_article(query: str, display: int = 10, start: int = 1, sort: str = "sim")Q&A検索
ネイバーで質問と回答を検索します。
search_kin(query: str, display: int = 10, start: int = 1, sort: str = "sim")ローカル検索
ネイバーで地域情報を検索します。
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