Naver OpenAPI

🚀 Naver MCP Server

A Naver OpenAPI server implemented using the Model Context Protocol (MCP). This project provides tools for interacting with various Naver services, such as searching blogs, news, books, etc.

🚀 Quick Start

To use the Naver MCP server, you need to apply for access to the Naver OpenAPI. You can register at the following link:

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

📦 Installation

Install via PyPi (Claude Desktop)

Install using Claude Desktop:

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>

Run directly on Claude Desktop:

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>

Install via PyPi (Cursor)

Install on Cursor:

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>

Install from Source Code

# Clone the repository
git clone https://github.com/pfldy2850/py-mcp-naver.git

# Install dependencies and run
pip install -r requirements.txt
python main.py

✨ Features

This server provides various tools for interacting with Naver services. The main features are as follows:

• Blog Search: Search Naver blog content using the search_blog function.
• News Search: Find relevant news reports using search_news.
• Web Search: Conduct general web searches using search_webkr.
• Image Search: Search for images using search_image and set filters.
• Shopping Search: Browse product information using search_shop and support filtering.

💻 Usage Examples

Installation and Configuration

1. Clone the repository and install dependencies:

git clone https://github.com/pfldy2850/py-mcp-naver.git
cd py-mcp-naver
pip install -r requirements.txt

2. Configure environment variables or set the Naver API client ID and secret directly in the code.

Basic Usage

from mcp_server import NaverMCP

# Initialize the server instance
naver = NaverMCP(client_id="your_client_id", client_secret="your_client_secret")

# Search for blog content
blogs = naver.search_blog(query="Python development")
print(blogs)

📚 Documentation

For the complete API documentation, please refer to the docs directory in the project repository or visit the official website.

📄 License

This project is open-source software licensed under the MIT License.