pfldy2850/py-mcp-naver

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):
sh
uv pip install mcp-naver
uv run python -m mcp-naver.hosts.claudedesktop \
-e NAVERCLIENTID= \
-e NAVERCLIENTSECRET=
Install it to Claude Desktop with:
sh
pip install mcp-naver
python -m mcp-naver.hosts.claudedesktop \
-e NAVERCLIENTID= \
-e NAVERCLIENTSECRET=
### from PyPi (Cursor)
Install it to Cursor with (uv):
sh
uv pip install mcp-naver
uv run python -m mcp-naver.hosts.cursor \
-e NAVERCLIENTID= \
-e NAVERCLIENTSECRET=
### from source
sh
# 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:
sh
# Start the server (Using FastMCP CLI)
fastmcp install mcpnaver/server.py -e NAVERCLIENTID= -e NAVERCLIENTSECRET=
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.
python
searchblog(query: str, display: int = 10, start: int = 1, sort: str = "sim")
### News Search
Search news articles on Naver.
python
searchnews(query: str, display: int = 10, start: int = 1, sort: str = "sim")
### Book Search
Search books on Naver.
python
searchbook(query: str, display: int = 10, start: int = 1, sort: str = "sim")
### Advanced Book Search
Get detailed book information using title or ISBN.
python
getbookadv(query: str = None, dtitl: str = None, disbn: str = None, ...)
### Adult Content Check
Check if a search term is adult content.
python
adultcheck(query: str)
### Encyclopedia Search
Search encyclopedia entries on Naver.
python
searchencyc(query: str, display: int = 10, start: int = 1)
### Cafe Article Search