Skip to main content
Glama
Naver MCP Server

Naver MCP Server

by pfldy2850

Naver MCP 服务器

使用模型上下文协议 (MCP) 实现 Naver OpenAPI 的服务器。该项目提供与各种 Naver 服务交互的工具,例如搜索博客、新闻、书籍等。

快速概览

安装

# 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

先决条件

要使用 Naver MCP 服务器,您需要申请访问 Naver Open API。您可以通过以下链接申请访问:

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

跑步

使用以下命令运行它:

# Start the server (Using FastMCP CLI)
fastmcp install src/server.py -e NAVER_CLIENT_ID=<YOUR NAVER CLIENT ID> -e NAVER_CLIENT_SECRET=<YOUR NAVER CLIENT SECRET>

该工具设置了创建与 Naver OpenAPI 集成的 MCP 服务器所需的一切。

Related MCP server: Naver Encyclopedia MCP Server

特征

该服务器提供以下与 Naver OpenAPI 交互的工具:

  • 博客搜索:在 Naver 上搜索博客文章。

  • 新闻搜索:在 Naver 上搜索新闻文章。

  • 图书搜索:搜索图书和高级图书信息。

  • 成人内容检查:检查搜索词是否为成人内容。

  • 百科全书搜索:搜索百科全书条目。

  • 咖啡馆文章搜索:在 Naver 咖啡馆中搜索文章。

  • 问答搜索:在 Naver 上搜索问题和答案。

  • 本地搜索:搜索本地信息。

  • 拼写纠正:纠正文本中的拼写错误。

  • 网页搜索:搜索网页。

  • 图像搜索:使用过滤器搜索图像。

  • 购物搜索:使用过滤器搜索购物商品。

  • 文档搜索:搜索文档。

Naver MCP 工具

服务器中实现了以下工具:

博客搜索

在 Naver 上搜索博客文章。

search_blog(query: str, display: int = 10, start: int = 1, sort: str = "sim")

新闻搜索

在 Naver 上搜索新闻文章。

search_news(query: str, display: int = 10, start: int = 1, sort: str = "sim")

图书搜索

在 Naver 上搜索书籍。

search_book(query: str, display: int = 10, start: int = 1, sort: str = "sim")

高级图书搜索

使用标题或 ISBN 获取详细的书籍信息。

get_book_adv(query: str = None, d_titl: str = None, d_isbn: str = None, ...)

成人内容检查

检查搜索词是否为成人内容。

adult_check(query: str)

百科全书搜索

在 Naver 上搜索百科全书条目。

search_encyc(query: str, display: int = 10, start: int = 1)

咖啡馆文章搜索

在 Naver 咖啡馆中搜索文章。

search_cafe_article(query: str, display: int = 10, start: int = 1, sort: str = "sim")

问答搜索

在 Naver 上搜索问题和答案。

search_kin(query: str, display: int = 10, start: int = 1, sort: str = "sim")

本地搜索

在 Naver 上搜索本地信息。

search_local(query: str, display: int = 10, start: int = 1, sort: str = "random")

拼写纠正

纠正给定文本中的拼写错误。

fix_spelling(query: str)

网页搜索

在 Naver 上搜索网页。

search_webkr(query: str, display: int = 10, start: int = 1)

图像搜索

使用过滤器在 Naver 上搜索图像。

search_image(query: str, display: int = 10, start: int = 1, sort: str = "sim", filter: str = "all")

购物搜索

使用过滤器在 Naver 上搜索购物商品。

search_shop(query: str, display: int = 10, start: int = 1, sort: str = "sim", filter: str = None, exclude: str = None)

文档搜索

在 Naver 上搜索文档。

search_doc(query: str, display: int = 10, start: int = 1)

执照

该项目是获得 MIT 许可的开源软件。

Available Tools

14 tools
adult_checkC

Check if the search term is adult content

Inputs: query (required).

fix_spellingC

Correct spelling errors in a given text

Inputs: query (required).

get_book_advD

Get book information from Naver

Inputs: sort, query, start, d_isbn, +2 more.

search_blogC

Search blog posts on Naver

Inputs: query (required), sort, start, display.

search_bookC

Search books on Naver

Inputs: query (required), sort, start, display.

search_cafe_articleC

Search cafe articles on Naver

Inputs: query (required), sort, start, display.

search_docC

Search documents on Naver

Inputs: query (required), start, display.

search_encycC

Search encyclopedia on Naver

Inputs: query (required), start, display.

search_imageC

Search images on Naver

Inputs: query (required), sort, start, filter, +1 more.

search_kinC

Search Q&A on Naver

Inputs: query (required), sort, start, display.

search_localC

Search local information on Naver

Inputs: query (required), sort, start, display.

search_newsC

Search news articles on Naver

Inputs: query (required), sort, start, display.

search_shopC

Search shopping items on Naver

Inputs: query (required), sort, start, filter, +2 more.

search_webkrC

Search web pages on Naver

Inputs: query (required), start, display.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.8/5.0

    Scored across 14 tools

    Disambiguation4/5

    Most tools are clearly separated by search domain (blog, news, book, image, shop, etc.), so an agent can usually pick the right one. Minor ambiguity exists between search_book and get_book_adv, and search_doc vs search_webkr may require interpretation.

    Naming Consistency4/5

    The dominant pattern is search_<domain>, used consistently across most tools. A few utility/detail tools deviate (get_book_adv, adult_check, fix_spelling), but they remain readable and not chaotic.

    Tool Count5/5

    14 tools is well within a reasonable range for a search-oriented MCP server. Each tool maps to a distinct Naver search category or small utility, so the count feels well-scoped.

    Completeness4/5

    The surface covers a broad set of Naver search domains plus adult-content checking and spelling correction. There are minor gaps such as limited detail-fetching beyond books and no obvious movie/other Naver search categories, but core search workflows are covered.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      C
      maintenance
      Naver Search API + Datalab API MCP server with 19 tools for Korean web search and trend analysis.
      19
      -
    • A
      license
      C
      quality
      D
      maintenance
      이 MCP 서버는 네이버 쇼핑인사이트 API와 검색 API를 통합하여 카테고리 및 키워드 트렌드를 조회하고 블로그, 쇼핑, 지식iN, 백과사전 검색을 수행할 수 있게 해줍니다.
      12
      1
      ISC