모델 컨텍스트 프로토콜(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 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.