Skip to main content
Glama
pfldy2850

Naver MCP Server

by pfldy2850

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

Related MCP server: Naver Search MCP Server

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=<YOUR NAVER CLIENT ID> \ -e NAVER_CLIENT_SECRET=<YOUR NAVER CLIENT SECRET>

Install it to Claude Desktop with:

pip install mcp-naver python -m mcp-naver.hosts.claude_desktop \ -e NAVER_CLIENT_ID=<YOUR NAVER CLIENT ID> \ -e NAVER_CLIENT_SECRET=<YOUR 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=<YOUR NAVER CLIENT ID> \ -e NAVER_CLIENT_SECRET=<YOUR 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=<YOUR NAVER CLIENT ID> -e NAVER_CLIENT_SECRET=<YOUR 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:

Search blog posts on Naver.

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

Search news articles on Naver.

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

Search books on Naver.

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

Get detailed book information using title or ISBN.

get_book_adv(query: str = None, d_titl: str = None, d_isbn: str = None, ...)

Adult Content Check

Check if a search term is adult content.

adult_check(query: str)

Search encyclopedia entries on Naver.

search_encyc(query: str, display: int = 10, start: int = 1)

Cafe Article Search

Search articles in Naver cafes.

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

Search questions and answers on Naver.

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

Search local information on Naver.

search_local(query: str, display: int = 10, start: int = 1, sort: str = "random")

Spelling Correction

Correct spelling errors in a given text.

fix_spelling(query: str)

Search web pages on Naver.

search_webkr(query: str, display: int = 10, start: int = 1)

Search images on Naver with filters.

search_image(query: str, display: int = 10, start: int = 1, sort: str = "sim", filter: str = "all")

Search shopping items on Naver with filters.

search_shop(query: str, display: int = 10, start: int = 1, sort: str = "sim", filter: str = None, exclude: str = None)

Search documents on Naver.

search_doc(query: str, display: int = 10, start: int = 1)

License

This project is open source software licensed as MIT.

-
security - not tested
A
license - permissive license
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/pfldy2850/py-mcp-naver'

If you have feedback or need assistance with the MCP directory API, please join our Discord server