Skip to content
Back to search

py-mcp-naver

python MCP NAVER

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/pfldy2850--py-mcp-naver/badge.svg)](/listings/pfldy2850--py-mcp-naver)

HTML

<a href="/listings/pfldy2850--py-mcp-naver"><img src="/api/listings/pfldy2850--py-mcp-naver/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

from PyPi (Claude Desktop)

Install it to Claude Desktop with (uv):

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>

Install it to Claude Desktop with:

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>

from PyPi (Cursor)

Install it to Cursor with (uv):

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>

from source

# 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

Run it with:

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

The tool sets up everything you need to create an MCP server integrated with Naver OpenAPI.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 179 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Naver MCP Server
  2. 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.
  3. ## Pre-requisite
  4. To use the Naver MCP server, you need to apply for access to the Naver Open API.
  5. You can apply for Open API access at the link below:
  6. https://developers.naver.com/apps/#/register=datalab
  7. ## Installation
  8. ### from PyPi (Claude Desktop)
  9. Install it to Claude Desktop with (uv):
  10. ```sh
  11. uv pip install mcp-naver
  12. uv run python -m mcp-naver.hosts.claude_desktop \
  13. -e NAVER_CLIENT_ID=<YOUR NAVER CLIENT ID> \
  14. -e NAVER_CLIENT_SECRET=<YOUR NAVER CLIENT SECRET>
  15. ```
  16. Install it to Claude Desktop with:
  17. ```sh
  18. pip install mcp-naver
  19. python -m mcp-naver.hosts.claude_desktop \
  20. -e NAVER_CLIENT_ID=<YOUR NAVER CLIENT ID> \
  21. -e NAVER_CLIENT_SECRET=<YOUR NAVER CLIENT SECRET>
  22. ```
  23. ### from PyPi (Cursor)
  24. Install it to Cursor with (uv):
  25. ```sh
  26. uv pip install mcp-naver
  27. uv run python -m mcp-naver.hosts.cursor \
  28. -e NAVER_CLIENT_ID=<YOUR NAVER CLIENT ID> \
  29. -e NAVER_CLIENT_SECRET=<YOUR NAVER CLIENT SECRET>
  30. ```
  31. ### from source
  32. ```sh
  33. # Clone the repository
  34. git clone https://github.com/pfldy2850/py-mcp-naver.git
  35. # Navigate into the project directory
  36. cd py-mcp-naver
  37. # Synchronize dependencies
  38. uv sync --dev --all-extras
  39. ```
  40. Run it with:
  41. ```sh
  42. # Start the server (Using FastMCP CLI)
  43. fastmcp install mcp_naver/server.py -e NAVER_CLIENT_ID=<YOUR NAVER CLIENT ID> -e NAVER_CLIENT_SECRET=<YOUR NAVER CLIENT SECRET>
  44. ```
  45. The tool sets up everything you need to create an MCP server integrated with Naver OpenAPI.
  46. ## Features
  47. This server provides the following tools for interacting with Naver OpenAPI:
  48. - **Blog Search**: Search blog posts on Naver.
  49. - **News Search**: Search news articles on Naver.
  50. - **Book Search**: Search books and advanced book information.
  51. - **Adult Content Check**: Check if a search term is adult content.
  52. - **Encyclopedia Search**: Search encyclopedia entries.
  53. - **Cafe Article Search**: Search articles in Naver cafes.
  54. - **Q&A Search**: Search questions and answers on Naver.
  55. - **Local Search**: Search local information.
  56. - **Spelling Correction**: Correct spelling errors in text.
  57. - **Web Search**: Search web pages.
  58. - **Image Search**: Search images with filters.
  59. - **Shopping Search**: Search shopping items with filters.
  60. - **Document Search**: Search documents.
  61. ## Naver MCP Tools
  62. The following tools are implemented in the server:
  63. ### Blog Search
  64. Search blog posts on Naver.
  65. ```python
  66. search_blog(query: str, display: int = 10, start: int = 1, sort: str = "sim")
  67. ```
  68. ### News Search
  69. Search news articles on Naver.
  70. ```python
  71. search_news(query: str, display: int = 10, start: int = 1, sort: str = "sim")
  72. ```
  73. ### Book Search
  74. Search books on Naver.
  75. ```python
  76. search_book(query: str, display: int = 10, start: int = 1, sort: str = "sim")
  77. ```
  78. ### Advanced Book Search
  79. Get detailed book information using title or ISBN.
  80. ```python
  81. get_book_adv(query: str = None, d_titl: str = None, d_isbn: str = None, ...)
  82. ```
  83. ### Adult Content Check
  84. Check if a search term is adult content.
  85. ```python
  86. adult_check(query: str)
  87. ```
  88. ### Encyclopedia Search
  89. Search encyclopedia entries on Naver.
  90. ```python
  91. search_encyc(query: str, display: int = 10, start: int = 1)
  92. ```
  93. ### Cafe Article Search
  94. Search articles in Naver cafes.
  95. ```python
  96. search_cafe_article(query: str, display: int = 10, start: int = 1, sort: str = "sim")
  97. ```
  98. ### Q&A Search
  99. Search questions and answers on Naver.
  100. ```python
  101. search_kin(query: str, display: int = 10, start: int = 1, sort: str = "sim")
  102. ```
  103. ### Local Search
  104. Search local information on Naver.
  105. ```python
  106. search_local(query: str, display: int = 10, start: int = 1, sort: str = "random")
  107. ```
  108. ### Spelling Correction
  109. Correct spelling errors in a given text.
  110. ```python
  111. fix_spelling(query: str)
  112. ```
  113. ### Web Search
  114. Search web pages on Naver.
  115. ```python
  116. search_webkr(query: str, display: int = 10, start: int = 1)
  117. ```
  118. ### Image Search
  119. Search images on Naver with filters.
  120. ```python
  121. search_image(query: str, display: int = 10, start: int = 1, sort: str = "sim", filter: str = "all")
  122. ```
  123. ### Shopping Search
  124. Search shopping items on Naver with filters.
  125. ```python
  126. search_shop(query: str, display: int = 10, start: int = 1, sort: str = "sim", filter: str = None, exclude: str = None)
  127. ```
  128. ### Document Search
  129. Search documents on Naver.
  130. ```python
  131. search_doc(query: str, display: int = 10, start: int = 1)
  132. ```
  133. ## License
  134. This project is open source software [licensed as MIT](https://opensource.org/licenses/MIT).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.