Skip to main content
Glama
Naver MCP Server

Naver MCP Server

by pfldy2850

ネイバー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 tools
adult_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

    C2.8/5.0

    Scored across 14 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • F
      license
      A
      quality
      C
      maintenance
      Naver Search API + Datalab API MCP server with 19 tools for Korean web search and trend analysis.
      19
      -
    • A
      license
      C
      quality
      D
      maintenance
      이 MCP 서버는 네이버 쇼핑인사이트 API와 검색 API를 통합하여 카테고리 및 키워드 트렌드를 조회하고 블로그, 쇼핑, 지식iN, 백과사전 검색을 수행할 수 있게 해줍니다.
      12
      1
      ISC