モデルコンテキストプロトコル(MCP)を用いたNaver OpenAPIのサーバー実装です。このプロジェクトは、検索ブログ、ニュース、書籍など、さまざまなNaverサービスとやり取りするためのツールを提供します。

前提条件

Naver MCPサーバーを利用するには、Naver Open APIへのアクセスを申請する必要があります。 以下のリンクからオープンAPIアクセスの申請が可能です:

https://developers.naver.com/apps/#/register=datalab

設置

PyPi(Claude Desktop)より ###

Claude Desktopに(UV)でインストールします:

Claude Desktopに以下でインストールしてください:

PyPi(カーソル)より

カーソルに(UV)でインストールする:

ソースより

以下で実行してください:

このツールは、Naver OpenAPIと統合されたMCPサーバーを作成するために必要なすべての準備を整えます。

特徴

このサーバーは、Naver OpenAPIとやり取りするための以下のツールを提供します:

• ブログ検索:Naverのブログ記事を検索できます。
• ニュース検索:Naverでニュース記事を検索できます。
• 書籍検索:書籍および高度な書籍情報を検索できます。
• アダルトコンテンツチェック:検索ワードがアダルトコンテンツかどうか確認してください。
• 百科事典検索:百科事典の項目を検索。
• カフェ記事検索:Naverカフェの記事検索。

Naver MCP Server

A server implementation for Naver OpenAPI using the Model Context Protocol (MCP). This project provides tools to interact with various Naver services, such as searching blogs, news, books, and more.

Pre-requisite

To use the Naver MCP server, you need to apply for access to the Naver Open API. You can apply for Open API access at the link below:

https://developers.naver.com/apps/#/register=datalab

Installation

from PyPi (Claude Desktop)

Install it to Claude Desktop with (uv):

uv pip install mcp-naver

uv run python -m mcp-naver.hosts.claude_desktop \
  -e NAVER_CLIENT_ID= \
  -e NAVER_CLIENT_SECRET=

Install it to Claude Desktop with:

pip install mcp-naver

python -m mcp-naver.hosts.claude_desktop \
  -e NAVER_CLIENT_ID= \
  -e NAVER_CLIENT_SECRET=

from PyPi (Cursor)

Install it to Cursor with (uv):

uv pip install mcp-naver

uv run python -m mcp-naver.hosts.cursor \
  -e NAVER_CLIENT_ID= \
  -e NAVER_CLIENT_SECRET=

from source

# 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

Run it with:

# Start the server (Using FastMCP CLI)
fastmcp install mcp_naver/server.py -e NAVER_CLIENT_ID= -e NAVER_CLIENT_SECRET=

The tool sets up everything you need to create an MCP server integrated with Naver OpenAPI.

Features

This server provides the following tools for interacting with Naver OpenAPI:

• Blog Search: Search blog posts on Naver.
• News Search: Search news articles on Naver.
• Book Search: Search books and advanced book information.
• Adult Content Check: Check if a search term is adult content.
• Encyclopedia Search: Search encyclopedia entries.
• Cafe Article Search: Search articles in Naver cafes.
• Q&A Search: Search questions and answers on Naver.
• Local Search: Search local information.
• Spelling Correction: Correct spelling errors in text.
• Web Search: Search web pages.
• Image Search: Search images with filters.
• Shopping Search: Search shopping items with filters.
• Document Search: Search documents.

Naver MCP Tools

The following tools are implemented in the server:

Blog Search

Search blog posts on Naver.

search_blog(query: str, display: int = 10, start: int = 1, sort: str = "sim")

News Search

Search news articles on Naver.

search_news(query: str, display: int = 10, start: int = 1, sort: str = "sim")

Book Search

Search books on Naver.

search_book(query: str, display: int = 10, start: int = 1, sort: str = "sim")

Advanced Book Search

Get detailed book information using title or ISBN.