Naver Encyclopedia

naver encyclopedia api mcp

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "cola314-naver-encyc-mcp": {
      "command": "python3",
      "args": [
        "src/server.py",
        "--mode",
        "stdin"
      ],
      "env": {
        "NAVER_CLIENT_ID": "YOUR_CLIENT_ID",
        "NAVER_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

You can run a MCP server that wraps the Naver Encyclopedia API to perform search queries through a consistent, model-based interface. It supports stdin/stdout and HTTP modes, with built-in error handling and tests to help you validate behavior.

How to use

To query the Naver Encyclopedia through this MCP server, start the server in one of two supported modes. In stdin/stdout mode you interact via standard input and output streams. In HTTP mode you expose an HTTP endpoint on your machine to handle requests from MCP clients.

Starting in stdin/stdout mode (recommended for local testing): use the following command to launch the server in a single, self-contained process. The server will read requests from standard input and write responses to standard output.

python3 src/server.py --mode stdin

Starting in HTTP mode (local development): the server will listen on a host and port you specify. Use this to connect from an MCP client over HTTP.

python3 src/server.py --mode http --host localhost --port 8000

If you prefer the convenience of the provided runner script, you can start in stdin mode using the runner. This uses the same underlying server but via the dedicated script.

python3 run_server.py --mode stdin

How to install

Prerequisites you need installed on your system: Python 3.x and pip for Python dependencies.

Step 1: Install dependencies.

pip install -r requirements.txt

Step 2: Prepare environment variables. Copy the example environment configuration and set your API credentials.

cp env.example .env

Edit the .env file to include your Naver API credentials.

NAVER_CLIENT_ID=your_client_id_here
NAVER_CLIENT_SECRET=your_client_secret_here

Step 3: Run tests (optional but recommended) to ensure the server and API client behave as expected.

PYTHONPATH=. python3 -m pytest tests/
# or to run a specific test
PYTHONPATH=. python3 -m pytest tests/test_server.py -v

Additional sections

Configuration and capabilities you can rely on include the MCP function that searches the encyclopedia with a given query and returns a structured result set including total matches, start index, display count, and an array of result items with titles, links, descriptions, and thumbnails.

Error handling covers common issues such as API errors, network problems, missing API keys, and unexpected failures. Error responses follow a standard format to help you diagnose problems quickly.

Project structure highlights include the MCP server entry at src/server.py, a Naver API client at src/naver_api.py, data models in src/models.py, and configuration management under src/config/settings.py.

Security note: ensure your API keys are kept secret and not embedded in client-side code. Use environment variables to supply credentials at runtime.

Available tools

search_encyclopedia

Searches Naver Encyclopedia with a given query and returns a structured response including total results, starting index, display count, and a list of result items with title, link, description, and thumbnail.