How do I install and run Py-MCP-Naver?

You can install it using `git clone` followed by `uv sync --dev --all-extras`. Run the server with `fastmcp install src/server.py -e NAVER_CLIENT_ID= -e NAVER_CLIENT_SECRET= `.

What is Py-MCP-Naver?

Py-MCP-Naver is a Python tool that enables you to interact with various Naver OpenAPI services through a Model Context Protocol (MCP) server, simplifying integration with Naver's ecosystem.

What credentials does it need?

It reads `NAVER_CLIENT_ID`, `NAVER_CLIENT_SECRET` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Py MCP Server

Enables interaction with Naver's OpenAPI services through a Model Context Protocol (MCP) server.

Local serverstdioPython★ 114

What is the Py MCP Server?

Enables interaction with Naver's OpenAPI services through a Model Context Protocol (MCP) server.

What you get

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.

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

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Py MCP Server

{
  "mcpServers": {
    "py-mcp-naver": {
      "command": "uvx",
      "args": ["mcp-naver"],
      "env": {
        "NAVER_CLIENT_ID": "your-value",
        "NAVER_CLIENT_SECRET": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

Variable	Description	Required
NAVER_CLIENT_ID	Configuration value read at startup.	Optional
NAVER_CLIENT_SECRET	Credential the server authenticates with.	Yes

Frequently asked questions

You can access a wide range of Naver services, including blog search, news search, book search, local search, image search, shopping search, and more.