Naver MCP Server
Servidor MCP de Naver
Una implementación de servidor para Naver OpenAPI que utiliza el Protocolo de Contexto de Modelo (MCP). Este proyecto proporciona herramientas para interactuar con diversos servicios de Naver, como la búsqueda en blogs, noticias, libros y más.
Descripción rápida
Instalación
# 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-extrasRequisito previo
Para usar el servidor MCP de Naver, debe solicitar acceso a la API abierta de Naver. Puede solicitar acceso a la API abierta en el siguiente enlace:
https://developers.naver.com/apps/#/register=datalab
Correr
Ejecútalo con:
# 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>La herramienta configura todo lo que necesita para crear un servidor MCP integrado con Naver OpenAPI.
Related MCP server: Naver Encyclopedia MCP Server
Características
Este servidor proporciona las siguientes herramientas para interactuar con Naver OpenAPI:
Búsqueda de blog : busque publicaciones de blog en Naver.
Búsqueda de noticias : busque artículos de noticias en Naver.
Búsqueda de libros : busque libros e información avanzada sobre libros.
Comprobación de contenido para adultos : comprueba si un término de búsqueda es contenido para adultos.
Búsqueda en enciclopedia : buscar entradas de enciclopedia.
Búsqueda de artículos en cafés : busque artículos en los cafés de Naver.
Búsqueda de preguntas y respuestas : busque preguntas y respuestas en Naver.
Búsqueda local : busque información local.
Corrección ortográfica : corrige errores ortográficos en el texto.
Búsqueda web : busca páginas web.
Búsqueda de imágenes : busque imágenes con filtros.
Búsqueda de compras : busque artículos de compra con filtros.
Búsqueda de documentos : buscar documentos.
Herramientas MCP de Naver
Las siguientes herramientas están implementadas en el servidor:
Búsqueda en el blog
Buscar publicaciones de blog en Naver.
search_blog(query: str, display: int = 10, start: int = 1, sort: str = "sim")Búsqueda de noticias
Busque artículos de noticias en Naver.
search_news(query: str, display: int = 10, start: int = 1, sort: str = "sim")Búsqueda de libros
Buscar libros en Naver.
search_book(query: str, display: int = 10, start: int = 1, sort: str = "sim")Búsqueda avanzada de libros
Obtenga información detallada del libro utilizando el título o ISBN.
get_book_adv(query: str = None, d_titl: str = None, d_isbn: str = None, ...)Comprobación de contenido para adultos
Comprueba si un término de búsqueda es contenido para adultos.
adult_check(query: str)Búsqueda en enciclopedia
Buscar entradas de enciclopedia en Naver.
search_encyc(query: str, display: int = 10, start: int = 1)Búsqueda de artículos de cafetería
Busque artículos en los cafés de Naver.
search_cafe_article(query: str, display: int = 10, start: int = 1, sort: str = "sim")Búsqueda de preguntas y respuestas
Busque preguntas y respuestas en Naver.
search_kin(query: str, display: int = 10, start: int = 1, sort: str = "sim")Búsqueda local
Busque información local en Naver.
search_local(query: str, display: int = 10, start: int = 1, sort: str = "random")Corrección ortográfica
Corregir errores ortográficos en un texto determinado.
fix_spelling(query: str)Búsqueda web
Buscar páginas web en Naver.
search_webkr(query: str, display: int = 10, start: int = 1)Búsqueda de imágenes
Busca imágenes en Naver con filtros.
search_image(query: str, display: int = 10, start: int = 1, sort: str = "sim", filter: str = "all")Búsqueda de compras
Busque artículos de compra en Naver con filtros.
search_shop(query: str, display: int = 10, start: int = 1, sort: str = "sim", filter: str = None, exclude: str = None)Búsqueda de documentos
Buscar documentos en Naver.
search_doc(query: str, display: int = 10, start: int = 1)Licencia
Este proyecto es un software de código abierto con licencia MIT .
Available Tools
14 toolsadult_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
Scored across 14 tools
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.
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.
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.
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
MCP server for real-time product search by barcode (EAN, UPC, GTIN) or keyword on ean-search.org
The Remote MCP server acts as a standardized bridge between LLM applications (like Claude, ChatGPT, and Cursor) and external services, enabling AI agents to access external tools and resources. Its primary capability is providing a centralized search tool to discover other MCP servers and their respective tools. Unlike local implementations, it runs remotely with OAuth authentication and permission controls for security.
MCP server for searching Airweave collections with natural language queries.
The Needle MCP server enables semantic search on documents stored in files like PDFs, DOCX, and XLSX by connecting AI applications to external data sources. It provides capabilities to create and manage document collections, perform natural language searches on stored content, and retrieve relevant information without requiring exact keyword matches.
Related MCP Servers
- AlicenseBqualityBmaintenanceAn MCP server that enables searching various content types (news, blogs, shopping, images, etc.) through Naver's search API.1989MIT
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that wraps Naver's encyclopedia search API, allowing users to search for information from Naver's encyclopedia through stdin/stdout or HTTP interfaces.-
- FlicenseAqualityCmaintenanceNaver Search API + Datalab API MCP server with 19 tools for Korean web search and trend analysis.19-
- AlicenseCqualityDmaintenance이 MCP 서버는 네이버 쇼핑인사이트 API와 검색 API를 통합하여 카테고리 및 키워드 트렌드를 조회하고 블로그, 쇼핑, 지식iN, 백과사전 검색을 수행할 수 있게 해줍니다.121ISC