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?

Py MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. 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

Configuration and credentials

You will need 2 environment variables: NAVER_CLIENT_ID, NAVER_CLIENT_SECRET. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Setting it up

mcp-naver on PyPI is all you need. Most clients run it directly, so configuration is a few lines and a restart.

Choosing this one

Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. It is maintained by pfldy2850; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the py mcp server does with a few real requests.

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

VariableDescriptionRequired
NAVER_CLIENT_IDConfiguration value read at startup.Optional
NAVER_CLIENT_SECRETCredential 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.