Серверная реализация для Naver OpenAPI с использованием протокола Model Context Protocol (MCP). Этот проект предоставляет инструменты для взаимодействия с различными сервисами Naver, такими как поиск в блогах, новостях, книгах и многом другом.

Предварительные требования

Чтобы использовать сервер Naver MCP, нужно подать заявку на доступ к API Naver Open.
Вы можете подать заявку на доступ к Open API по ссылке ниже:

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

Установка

от PyPi (Claude Desktop)

Установите его на Claude Desktop с помощью (uv):

Установите его на Claude Desktop с:

от PyPi (Курсор)

Установите его на Cursor с помощью (uv):

из источника

Проведите его с:

Инструмент настраивает всё необходимое для создания MCP-сервера, интегрированного с Naver OpenAPI.

Особенности

Этот сервер предоставляет следующие инструменты для взаимодействия с 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.