@isnow890/naver-search-mcp 1.0.53 → 1.0.55

package/dist/src/clients/naver-api-error.js

@@ -6,6 +6,11 @@ const SWAPPED_KEY_HINT = {
     legacy: "인증에 실패했습니다. NAVER API HUB 키를 NAVER_CLIENT_ID/NAVER_CLIENT_SECRET에 넣지 않았는지 확인하세요. HUB 키는 NCP_APIGW_API_KEY_ID/NCP_APIGW_API_KEY에 넣어야 합니다.",
     hub: "인증에 실패했습니다. 개발자센터 키를 NCP_APIGW_API_KEY_ID/NCP_APIGW_API_KEY에 넣지 않았는지 확인하세요. 개발자센터 키는 NAVER_CLIENT_ID/NAVER_CLIENT_SECRET에 넣어야 합니다.",
 };
+// HUB는 키가 맞아도 Application에 해당 API가 켜져 있지 않으면 401을 준다.
+// 이때는 키를 바꿔 넣으라는 힌트가 오히려 사용자를 엉뚱한 곳으로 보낸다.
+// 키 자체가 틀리면 본문이 "Authentication Failed"로 온다 (2026-10-21 실측).
+const HUB_API_NOT_ENABLED = /요청한 API는 이 Application에서 활성화되어 있지 않습니다/;
+const HUB_API_NOT_ENABLED_HINT = "키는 정상이지만 이 API가 NAVER API HUB Application에서 활성화되어 있지 않습니다. NAVER Cloud Platform 콘솔 > NAVER API HUB에서 해당 Application에 이 API를 활성화하세요.";
 function stringifyBody(body) {
     if (body === undefined || body === null)
         return "";
@@ -27,7 +32,9 @@ export function formatApiError(provider, url, status, body) {
     const bodyText = stringifyBody(body);
     if (bodyText)
         lines.push(bodyText);
-    if (status === 401)
-        lines.push(SWAPPED_KEY_HINT[provider]);
+    if (status === 401) {
+        const notEnabled = provider === "hub" && HUB_API_NOT_ENABLED.test(bodyText);
+        lines.push(notEnabled ? HUB_API_NOT_ENABLED_HINT : SWAPPED_KEY_HINT[provider]);
+    }
     return lines.join("\n");
 }

package/dist/src/handlers/datalab.handlers.js

@@ -1,7 +1,8 @@
 import { NaverSearchClient } from "../clients/naver-search.client.js";
 import { resolveDateRange } from "../utils/date.utils.js";
-// 클라이언트 인스턴스 (싱글톤)
-const client = NaverSearchClient.getInstance();
+// 클라이언트는 호출 시점에 꺼낸다. 모듈 로드 시점에 잡아두면 설정 변경으로
+// resetServerInstance()가 싱글톤을 교체한 뒤에도 비워진 옛 인스턴스를 계속 쓴다.
+const client = () => NaverSearchClient.getInstance();
 /**
  * 데이터랩 도구 핸들러 맵
  * 각 도구 이름을 키로, 실행할 핸들러 함수를 값으로 가짐
@@ -52,7 +53,7 @@ export const datalabToolHandlers = {
  */
 export async function handleSearchTrend(params) {
     const { startDate, endDate } = resolveDateRange(params.startDate, params.endDate);
-    return client.searchTrend({ ...params, startDate, endDate });
+    return client().searchTrend({ ...params, startDate, endDate });
 }
 /**
  * 쇼핑 카테고리 트렌드 핸들러
@@ -61,7 +62,7 @@ export async function handleSearchTrend(params) {
  */
 export async function handleShoppingCategoryTrend(params) {
     const { startDate, endDate } = resolveDateRange(params.startDate, params.endDate);
-    return client.datalabShoppingCategory({ ...params, startDate, endDate });
+    return client().datalabShoppingCategory({ ...params, startDate, endDate });
 }
 /**
  * 쇼핑 기기별 트렌드 핸들러
@@ -70,7 +71,7 @@ export async function handleShoppingCategoryTrend(params) {
  */
 export async function handleShoppingByDeviceTrend(params) {
     const { startDate, endDate } = resolveDateRange(params.startDate, params.endDate);
-    return client.datalabShoppingByDevice({
+    return client().datalabShoppingByDevice({
         startDate,
         endDate,
         timeUnit: params.timeUnit,
@@ -85,7 +86,7 @@ export async function handleShoppingByDeviceTrend(params) {
  */
 export async function handleShoppingByGenderTrend(params) {
     const { startDate, endDate } = resolveDateRange(params.startDate, params.endDate);
-    return client.datalabShoppingByGender({
+    return client().datalabShoppingByGender({
         startDate,
         endDate,
         timeUnit: params.timeUnit,
@@ -100,7 +101,7 @@ export async function handleShoppingByGenderTrend(params) {
  */
 export async function handleShoppingByAgeTrend(params) {
     const { startDate, endDate } = resolveDateRange(params.startDate, params.endDate);
-    return client.datalabShoppingByAge({
+    return client().datalabShoppingByAge({
         startDate,
         endDate,
         timeUnit: params.timeUnit,
@@ -115,7 +116,7 @@ export async function handleShoppingByAgeTrend(params) {
  */
 export async function handleShoppingKeywordsTrend(params) {
     const { startDate, endDate } = resolveDateRange(params.startDate, params.endDate);
-    return client.datalabShoppingKeywords({
+    return client().datalabShoppingKeywords({
         startDate,
         endDate,
         timeUnit: params.timeUnit,
@@ -130,7 +131,7 @@ export async function handleShoppingKeywordsTrend(params) {
  */
 export async function handleShoppingKeywordByDeviceTrend(params) {
     const { startDate, endDate } = resolveDateRange(params.startDate, params.endDate);
-    return client.datalabShoppingKeywordByDevice({
+    return client().datalabShoppingKeywordByDevice({
         startDate,
         endDate,
         timeUnit: params.timeUnit,
@@ -146,7 +147,7 @@ export async function handleShoppingKeywordByDeviceTrend(params) {
  */
 export async function handleShoppingKeywordByGenderTrend(params) {
     const { startDate, endDate } = resolveDateRange(params.startDate, params.endDate);
-    return client.datalabShoppingKeywordByGender({
+    return client().datalabShoppingKeywordByGender({
         startDate,
         endDate,
         timeUnit: params.timeUnit,
@@ -162,7 +163,7 @@ export async function handleShoppingKeywordByGenderTrend(params) {
  */
 export async function handleShoppingKeywordByAgeTrend(params) {
     const { startDate, endDate } = resolveDateRange(params.startDate, params.endDate);
-    return client.datalabShoppingKeywordByAge({
+    return client().datalabShoppingKeywordByAge({
         startDate,
         endDate,
         timeUnit: params.timeUnit,

package/dist/src/handlers/search.handlers.js

@@ -1,7 +1,8 @@
 import { NaverSearchClient } from "../clients/naver-search.client.js";
 import { SearchArgsSchema } from "../schemas/search.schemas.js";
-// 클라이언트 인스턴스
-const client = NaverSearchClient.getInstance();
+// 클라이언트는 호출 시점에 꺼낸다. 모듈 로드 시점에 잡아두면 설정 변경으로
+// resetServerInstance()가 싱글톤을 교체한 뒤에도 비워진 옛 인스턴스를 계속 쓴다.
+const client = () => NaverSearchClient.getInstance();
 export const searchToolHandlers = {
     search_webkr: (args) => {
         console.error("search_webkr called with args:", JSON.stringify(args, null, 2));
@@ -40,45 +41,44 @@ export const searchToolHandlers = {
  * 지식백과 검색 핸들러
  */
 export async function handleEncycSearch(params) {
-    return client.search("encyc", params);
+    return client().search("encyc", params);
 }
 /**
  * 이미지 검색 핸들러
  */
 export async function handleImageSearch(params) {
-    return client.search("image", params);
+    return client().search("image", params);
 }
 /**
  * 지식iN 검색 핸들러
  */
 export async function handleKinSearch(params) {
-    return client.search("kin", params);
+    return client().search("kin", params);
 }
 /**
  * 지역 검색 핸들러
  */
 export async function handleLocalSearch(params) {
-    return client.searchLocal(params);
+    return client().searchLocal(params);
 }
 /**
  * 뉴스 검색 핸들러
  */
 export async function handleNewsSearch(params) {
-    return client.search("news", params);
+    return client().search("news", params);
 }
 /**
  * 블로그 검색 핸들러
  */
 export async function handleBlogSearch(params) {
-    return client.search("blog", params);
+    return client().search("blog", params);
 }
 /**
  * 카페글 검색 핸들러
  */
 export async function handleCafeArticleSearch(params) {
-    return client.search("cafearticle", params);
+    return client().search("cafearticle", params);
 }
 export async function handleWebKrSearch(args) {
-    const client = NaverSearchClient.getInstance();
-    return await client.search("webkr", args);
+    return client().search("webkr", args);
 }

package/dist/src/index.d.ts

@@ -1,5 +1,4 @@
 #!/usr/bin/env node
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 export declare const configSchema: z.ZodObject<{
     NAVER_CLIENT_ID: z.ZodOptional<z.ZodString>;
@@ -23,7 +22,7 @@ export declare const configSchema: z.ZodObject<{
 export declare function resetServerInstance(): void;
 export declare function createNaverSearchServer({ config, }: {
     config: z.infer<typeof configSchema>;
-}): McpServer | import("@modelcontextprotocol/sdk/server/index.js").Server<{
+}): import("@modelcontextprotocol/sdk/server/index.js").Server<{
     method: string;
     params?: {
         [x: string]: unknown;

package/dist/src/index.js

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+import { readFileSync, realpathSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
@@ -10,6 +13,9 @@ import { DatalabSearchSchema, DatalabShoppingSchema, DatalabShoppingDeviceSchema
 import { FindCategorySchema } from "./schemas/category.schemas.js";
 import { findCategoryHandler, clearCategoriesCache } from "./handlers/category.handlers.js";
 import { resolveCredentials } from "./config/credentials.js";
+// 빌드 결과물(dist/src/index.js) 기준 두 단계 위가 패키지 루트다.
+// 버전을 하드코딩하면 릴리스할 때마다 serverInfo가 뒤처진다.
+const { version: PACKAGE_VERSION } = JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url)), "..", "..", "package.json"), "utf8").toString());
 // Configuration schema for programmatic server creation and stdio startup
 export const configSchema = z.object({
     NAVER_CLIENT_ID: z.string().optional().describe("네이버 개발자센터 Client ID"),
@@ -61,13 +67,14 @@ export function createNaverSearchServer({ config, }) {
         resetServerInstance();
     }
     // Reuse existing server instance to prevent memory leaks
+    // 첫 호출과 같은 타입(Server)을 돌려줘야 호출 횟수에 따라 반환값이 달라지지 않는다.
     if (globalServerInstance) {
-        return globalServerInstance;
+        return globalServerInstance.server;
     }
     // Create a new MCP server only once
     const server = new McpServer({
         name: "naver-search",
-        version: "1.0.49",
+        version: PACKAGE_VERSION,
     });
     // Initialize Naver client with config
     const credentials = resolveCredentials(config);
@@ -350,35 +357,24 @@ async function main() {
 // Note: Always run main in CLI mode since this is an MCP server
 console.error("Starting MCP server initialization...");
 console.error("process.argv:", process.argv);
-// Check if running as main module - compatible with both ESM and CommonJS
-let isMainModule = false;
-try {
-    // Try ESM approach first
-    if (typeof import.meta !== "undefined" && import.meta.url) {
-        console.error("import.meta.url:", import.meta.url);
-        isMainModule =
-            import.meta.url === `file://${process.argv[1]}` ||
-                import.meta.url.endsWith(process.argv[1]) ||
-                process.argv[1].endsWith("index.js");
-    }
-    else {
-        // Fallback for CommonJS or when import.meta is not available
-        isMainModule =
-            process.argv[1].endsWith("index.js") ||
-                process.argv[1].includes("naver-search-mcp");
+/**
+ * 이 파일이 진입점으로 실행됐는지 판별한다.
+ * npx·전역 설치는 bin 심볼릭 링크로 실행되므로 argv[1]과 이 파일을 realpath로 비교한다.
+ * 파일명("index.js")이나 argv 문자열("naver-search-mcp")로 추측하면, 이 모듈을
+ * import만 한 다른 프로그램에서도 stdio 서버가 떠서 프로세스를 가로챈다.
+ */
+function isEntryPoint() {
+    if (!process.argv[1])
+        return false;
+    try {
+        return (realpathSync(process.argv[1]) ===
+            realpathSync(fileURLToPath(import.meta.url)));
     }
-    // Additional check for NPX execution
-    if (!isMainModule && process.argv.some(arg => arg.includes('naver-search-mcp'))) {
-        isMainModule = true;
-        console.error("Detected NPX execution, forcing main module mode");
+    catch {
+        return false;
     }
 }
-catch (error) {
-    // Fallback for environments where import.meta causes issues
-    isMainModule =
-        process.argv[1].endsWith("index.js") ||
-            process.argv[1].includes("naver-search-mcp");
-}
+const isMainModule = isEntryPoint();
 console.error("isMainModule:", isMainModule);
 if (isMainModule) {
     console.error("Running as main module, starting server...");

package/package.json

@@ -1,10 +1,9 @@
 {
   "name": "@isnow890/naver-search-mcp",
-  "version": "1.0.53",
+  "version": "1.0.55",
   "description": "Naver Search MCP Server",
   "main": "dist/src/index.js",
-  "module": "./src/index.ts",
-  "types": "dist/index.d.ts",
+  "types": "dist/src/index.d.ts",
   "files": [
     "dist"
   ],