@isnow890/naver-search-mcp 1.0.7 → 1.0.18

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 isnow890
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE. 
+MIT License
+
+Copyright (c) 2025 isnow890
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 

package/README.md

@@ -1,205 +1,187 @@
-# Naver Search MCP Server
-
-[![한국어](https://img.shields.io/badge/한국어-README-yellow)](README-ko.md)
-[![smithery badge](https://smithery.ai/badge/@isnow890/naver-search-mcp)](https://smithery.ai/server/@isnow890/naver-search-mcp)
-[![MCP.so](https://img.shields.io/badge/MCP.so-Naver%20Search%20MCP-blue)](https://mcp.so/server/naver-search-mcp/isnow890)
-
-MCP server for Naver Search API and DataLab API integration, enabling comprehensive search across various Naver services and data trend analysis.
-
-#### Version History
-
-###### 1.0.2 (2025-04-26)
-
-- README updated: cafe article search tool and version history section improved
-
-###### 1.0.1 (2025-04-26)
-
-- Cafe article search feature added
-- Shopping category info added to zod
-- Source code refactored
-
-###### 1.0.0 (2025-04-08)
-
-- Initial release
-
-#### Information
-
-**If you want to install the MCP via npm, do NOT use @mseep/server-naver-search (https://www.npmjs.com/package/@mseep/server-naver-search). That package is a copy of my work and was published without my permission. The npx version of that package is also broken and will not work properly. Please use this official package instead.**
-
-#### Prerequisites
-
-- Naver Developers API Key (Client ID and Secret)
-- Node.js 18 or higher
-- NPM 8 or higher
-- Docker (optional, for container deployment)
-
-#### Getting API Keys
-
-1. Visit [Naver Developers](https://developers.naver.com/apps/#/register)
-2. Click "Register Application"
-3. Enter application name and select ALL of the following APIs:
-   - Search (for blog, news, book search, etc.)
-   - DataLab (Search Trends)
-   - DataLab (Shopping Insight)
-4. Set the obtained Client ID and Client Secret as environment variables
-
-## Tool Details
-
-### Available tools:
-
-- **search_webkr**: Search Naver web documents
-- **search_news**: Search Naver news
-- **search_blog**: Search Naver blogs
-- **search_cafearticle**: Search Naver cafe articles
-- **search_shop**: Search Naver shopping
-- **search_image**: Search Naver images
-- **search_kin**: Search Naver KnowledgeiN
-- **search_book**: Search Naver books
-- **search_encyc**: Search Naver encyclopedia
-- **search_academic**: Search Naver academic papers
-- **search_local**: Search Naver local places
-- **datalab_search**: Analyze search term trends
-- **datalab_shopping_category**: Analyze shopping category trends
-- **datalab_shopping_by_device**: Analyze shopping trends by device
-- **datalab_shopping_by_gender**: Analyze shopping trends by gender
-- **datalab_shopping_by_age**: Analyze shopping trends by age group
-- **datalab_shopping_keywords**: Analyze shopping keyword trends
-- **datalab_shopping_keyword_by_device**: Analyze shopping keyword trends by device
-- **datalab_shopping_keyword_by_gender**: Analyze shopping keyword trends by gender
-- **datalab_shopping_keyword_by_age**: Analyze shopping keyword trends by age group
-
-## Installation
-
-### Option 1: Quick Install via Smithery (Recommended)
-
-To install Naver Search MCP Server automatically via Smithery, use one of these commands based on your AI client:
-
-For Claude Desktop:
-
-```bash
-npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client claude
-```
-
-For Cursor:
-
-```bash
-npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client cursor
-```
-
-For Windsurf:
-
-```bash
-npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client windsurf
-```
-
-For Cline:
-
-```bash
-npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client cline
-```
-
-The installer will prompt you for:
-
-- NAVER_CLIENT_ID
-- NAVER_CLIENT_SECRET
-
-### Option 2: Manual Installation
-
-#### Environment Variables
-
-```bash
-# Windows
-set NAVER_CLIENT_ID=your_client_id
-set NAVER_CLIENT_SECRET=your_client_secret
-
-# Linux/Mac
-export NAVER_CLIENT_ID=your_client_id
-export NAVER_CLIENT_SECRET=your_client_secret
-```
-
-#### Run with NPX
-
-```bash
-npx @isnow890/naver-search-mcp
-```
-
-#### Run with Docker
-
-```bash
-docker run -i --rm \
-  -e NAVER_CLIENT_ID=your_client_id \
-  -e NAVER_CLIENT_SECRET=your_client_secret \
-  mcp/naver-search
-```
-
-## Claude Desktop Configuration
-
-Add to `claude_desktop_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "naver-search": {
-      "command": "npx",
-      "args": ["-y", "@isnow890/naver-search-mcp"],
-      "env": {
-        "NAVER_CLIENT_ID": "your_client_id",
-        "NAVER_CLIENT_SECRET": "your_client_secret"
-      }
-    }
-  }
-}
-```
-
-## Cursor AI Configuration
-
-Add to `mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "naver-search": {
-      "command": "npx",
-      "args": ["-y", "@isnow890/naver-search-mcp"],
-      "env": {
-        "NAVER_CLIENT_ID": "your_client_id",
-        "NAVER_CLIENT_SECRET": "your_client_secret"
-      }
-    }
-  }
-}
-```
-
-For Docker:
-
-```json
-{
-  "mcpServers": {
-    "naver-search": {
-      "command": "docker",
-      "args": [
-        "run",
-        "-i",
-        "--rm",
-        "-e",
-        "NAVER_CLIENT_ID=your_client_id",
-        "-e",
-        "NAVER_CLIENT_SECRET=your_client_secret",
-        "mcp/naver-search"
-      ]
-    }
-  }
-}
-```
-
-## Build
-
-Docker build:
-
-```bash
-docker build -t mcp/naver-search .
-```
-
-## License
-
-MIT License
+# Naver Search MCP Server
+
+[![한국어](https://img.shields.io/badge/한국어-README-yellow)](README-ko.md)
+[![smithery badge](https://smithery.ai/badge/@isnow890/naver-search-mcp)](https://smithery.ai/server/@isnow890/naver-search-mcp)
+[![MCP.so](https://img.shields.io/badge/MCP.so-Naver%20Search%20MCP-blue)](https://mcp.so/server/naver-search-mcp/isnow890)
+
+MCP server for Naver Search API and DataLab API integration, enabling comprehensive search across various Naver services and data trend analysis.
+
+#### Version History
+
+###### 1.0.2 (2025-04-26)
+
+- README updated: cafe article search tool and version history section improved
+
+###### 1.0.1 (2025-04-26)
+
+- Cafe article search feature added
+- Shopping category info added to zod
+- Source code refactored
+
+###### 1.0.0 (2025-04-08)
+
+- Initial release
+
+#### Information
+
+**If you want to install the MCP via npm, do NOT use @mseep/server-naver-search (https://www.npmjs.com/package/@mseep/server-naver-search). That package is a copy of my work and was published without my permission. The npx version of that package is also broken and will not work properly. Please use this official package instead.**
+
+#### Prerequisites
+
+- Naver Developers API Key (Client ID and Secret)
+- Node.js 18 or higher
+- NPM 8 or higher
+- Docker (optional, for container deployment)
+
+#### Getting API Keys
+
+1. Visit [Naver Developers](https://developers.naver.com/apps/#/register)
+2. Click "Register Application"
+3. Enter application name and select ALL of the following APIs:
+   - Search (for blog, news, book search, etc.)
+   - DataLab (Search Trends)
+   - DataLab (Shopping Insight)
+4. Set the obtained Client ID and Client Secret as environment variables
+
+## Tool Details
+
+### Available tools:
+
+- **search_webkr**: Search Naver web documents
+- **search_news**: Search Naver news
+- **search_blog**: Search Naver blogs
+- **search_cafearticle**: Search Naver cafe articles
+- **search_shop**: Search Naver shopping
+- **search_image**: Search Naver images
+- **search_kin**: Search Naver KnowledgeiN
+- **search_book**: Search Naver books
+- **search_encyc**: Search Naver encyclopedia
+- **search_academic**: Search Naver academic papers
+- **search_local**: Search Naver local places
+- **datalab_search**: Analyze search term trends
+- **datalab_shopping_category**: Analyze shopping category trends
+- **datalab_shopping_by_device**: Analyze shopping trends by device
+- **datalab_shopping_by_gender**: Analyze shopping trends by gender
+- **datalab_shopping_by_age**: Analyze shopping trends by age group
+- **datalab_shopping_keywords**: Analyze shopping keyword trends
+- **datalab_shopping_keyword_by_device**: Analyze shopping keyword trends by device
+- **datalab_shopping_keyword_by_gender**: Analyze shopping keyword trends by gender
+- **datalab_shopping_keyword_by_age**: Analyze shopping keyword trends by age group
+
+## Installation
+
+### Option 1: Quick Install via Smithery (Recommended)
+
+To install Naver Search MCP Server automatically via Smithery, use one of these commands based on your AI client:
+
+For Claude Desktop:
+
+```bash
+npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client claude
+```
+
+For Cursor:
+
+```bash
+npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client cursor
+```
+
+For Windsurf:
+
+```bash
+npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client windsurf
+```
+
+For Cline:
+
+```bash
+npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client cline
+```
+
+The installer will prompt you for:
+
+- NAVER_CLIENT_ID
+- NAVER_CLIENT_SECRET
+
+### Option 2: Manual Installation
+
+#### Environment Variables
+
+```bash
+# Windows
+set NAVER_CLIENT_ID=your_client_id
+set NAVER_CLIENT_SECRET=your_client_secret
+
+# Linux/Mac
+export NAVER_CLIENT_ID=your_client_id
+export NAVER_CLIENT_SECRET=your_client_secret
+```
+
+#### Run with NPX
+
+```bash
+npx @modelcontextprotocol/server-naver-search
+```
+
+#### Run with Docker
+
+```bash
+docker run -i --rm \
+  -e NAVER_CLIENT_ID=your_client_id \
+  -e NAVER_CLIENT_SECRET=your_client_secret \
+  mcp/naver-search
+```
+
+## Cursor Desktop Configuration
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "naver-search": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-naver-search"],
+      "env": {
+        "NAVER_CLIENT_ID": "your_client_id",
+        "NAVER_CLIENT_SECRET": "your_client_secret"
+      }
+    }
+  }
+}
+```
+
+For Docker:
+
+```json
+{
+  "mcpServers": {
+    "naver-search": {
+      "command": "docker",
+      "args": [
+        "run",
+        "-i",
+        "--rm",
+        "-e",
+        "NAVER_CLIENT_ID=your_client_id",
+        "-e",
+        "NAVER_CLIENT_SECRET=your_client_secret",
+        "mcp/naver-search"
+      ]
+    }
+  }
+}
+```
+## Build
+
+Docker build:
+
+```bash
+docker build -t mcp/naver-search .
+```
+
+
+
+## License
+
+MIT License

package/dist/package.json

@@ -0,0 +1,39 @@
+{
+    "name": "@isnow890/naver-search-mcp",
+    "version": "1.0.18",
+    "description": "Naver Search MCP Server",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "prebuild": "shx rm -rf dist",
+        "build": "tsc",
+        "prepare": "npm run build",
+        "watch": "tsc --watch",
+        "start": "node dist/src/index.js"
+    },
+    "engines": {
+        "node": ">=18"
+    },
+    "dependencies": {
+        "@modelcontextprotocol/sdk": "1.10.2",
+        "axios": "^1.6.7",
+        "zod": "^3.22.4",
+        "zod-to-json-schema": "^3.23.5",
+        "sharp": "^0.33.2",
+        "dotenv": "^16.4.5"
+    },
+    "devDependencies": {
+        "@types/node": "^22",
+        "shx": "^0.3.4",
+        "typescript": "^5.3.3"
+    },
+    "author": "isnow890",
+    "license": "MIT",
+    "bin": {
+        "naver-search-mcp": "dist/src/index.js"
+    },
+    "type": "module"
+}

package/dist/src/index.js

@@ -1,4 +1,7 @@
+#!/usr/bin/env node
 import * as dotenv from "dotenv";
+import pkg from "../package.json" with { type: "json" };
+console.error("[MCP] dotenv import 완료");
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
@@ -8,12 +11,13 @@ import { datalabTools } from "./tools/datalab.tools.js";
 import { searchToolHandlers } from "./handlers/search.handlers.js";
 import { datalabToolHandlers } from "./handlers/datalab.handlers.js";
 dotenv.config();
-console.log("서버 실행 준비 중...");
+console.error("[MCP] dotenv.config() 실행됨");
 // 환경 변수 유효성 검사
 const NAVER_CLIENT_ID = process.env.NAVER_CLIENT_ID;
 const NAVER_CLIENT_SECRET = process.env.NAVER_CLIENT_SECRET;
+console.error("[MCP] 환경변수 읽음", { NAVER_CLIENT_ID, NAVER_CLIENT_SECRET });
 if (!NAVER_CLIENT_ID || !NAVER_CLIENT_SECRET) {
-    console.error("Error: NAVER_CLIENT_ID and NAVER_CLIENT_SECRET environment variables are required");
+    console.error("[MCP] Error: NAVER_CLIENT_ID and NAVER_CLIENT_SECRET environment variables are required");
     process.exit(1);
 }
 // 네이버 검색 클라이언트 초기화
@@ -22,17 +26,20 @@ client.initialize({
     clientId: NAVER_CLIENT_ID,
     clientSecret: NAVER_CLIENT_SECRET,
 });
+console.error("[MCP] NaverSearchClient 초기화 완료");
 // MCP 서버 인스턴스 생성
 const server = new Server({
     name: "naver-search",
-    version: "1.0.6",
+    version: pkg.version,
 }, {
     capabilities: {
         tools: {},
     },
 });
+console.error("[MCP] Server 인스턴스 생성 완료");
 // 도구 목록을 반환하는 핸들러 등록
 server.setRequestHandler(ListToolsRequestSchema, async () => {
+    console.error("[MCP] ListToolsRequestSchema 핸들러 호출됨");
     return {
         tools: [...searchTools, ...datalabTools],
     };
@@ -44,7 +51,7 @@ const toolHandlers = {
 // 에러 응답 헬퍼 함수
 function createErrorResponse(error) {
     const errorMessage = error instanceof Error ? error.message : String(error);
-    console.error("API Error:", errorMessage);
+    console.error("[MCP] API Error:", errorMessage);
     return {
         content: [{ type: "text", text: `Error: ${errorMessage}` }],
         isError: true,
@@ -54,7 +61,7 @@ function createErrorResponse(error) {
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
     try {
         const { name, arguments: args } = request.params;
-        console.error(`Executing tool: ${name} with args:`, args);
+        console.error(`[MCP] Executing tool: ${name} with args:`, args);
         if (!args) {
             throw new Error("Arguments are required");
         }
@@ -62,7 +69,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         if (!handler)
             throw new Error(`Unknown tool: ${name}`);
         const result = await handler(args);
-        console.error(`Tool ${name} executed successfully`);
+        console.error(`[MCP] Tool ${name} executed successfully`);
         return {
             content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
         };
@@ -74,24 +81,26 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 // 서버 시작 함수
 async function runServer() {
     try {
+        console.error("[MCP] runServer 진입");
         const transport = new StdioServerTransport();
         // 서버 에러 핸들링
         process.on("uncaughtException", (error) => {
-            console.error("Uncaught Exception:", error);
+            console.error("[MCP] Uncaught Exception:", error);
         });
         process.on("unhandledRejection", (reason, promise) => {
-            console.error("Unhandled Rejection at:", promise, "reason:", reason);
+            console.error("[MCP] Unhandled Rejection at:", promise, "reason:", reason);
         });
         await server.connect(transport);
-        console.error("Naver Search MCP Server running on stdio");
+        console.error("[MCP] Naver Search MCP Server running on stdio");
     }
     catch (error) {
-        console.error("Fatal error running server:", error);
+        console.error("[MCP] Fatal error running server:", error);
         process.exit(1);
     }
 }
 // 서버 시작
+console.error("[MCP] runServer 호출 직전");
 runServer().catch((error) => {
-    console.error("Fatal error running server:", error);
+    console.error("[MCP] Fatal error running server (catch):", error);
     process.exit(1);
 });