ネイバー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 サーバーを作成するために必要なものをすべて設定します。

特徴

このサーバーは、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 ライセンスのオープンソースソフトウェアです。

Naver MCP Server

Integrations