Naver Search MCP Server

Instructions

Implementation Reference

• src/handlers/search.handlers.ts:85-90 (handler)

  Core handler function for search_kin tool that executes the Naver Kin search by calling client.search("kin", params)

  /**
   * 지식iN 검색 핸들러
   */
  export async function handleKinSearch(params: SearchArgs) {
    return client.search("kin", params);
  }

• src/handlers/search.handlers.ts:31-33 (handler)

  Tool handler entry point in searchToolHandlers that validates args and delegates to handleKinSearch

  search_kin: (args) => {
    console.error("search_kin called with args:", JSON.stringify(args, null, 2));
    return handleKinSearch(SearchArgsSchema.parse(args));

• src/index.ts:177-189 (registration)

  MCP server registration of the search_kin tool, specifying description, input schema, and handler that calls searchToolHandlers.search_kin

  server.registerTool(
    "search_kin",
    {
      description:
        "❓ Search Naver KnowledgeiN for Q&A and community-driven answers. Find solutions to problems, get expert advice, and discover community insights on various topics. For recent questions or current discussions, use get_current_korean_time first. (네이버 지식iN 검색 - 질문과 답변, 커뮤니티 지식, 최근 질문이나 현재 토론을 찾을 때는 먼저 get_current_korean_time으로 현재 시간을 확인하세요)",
      inputSchema: SearchArgsSchema.shape,
    },
    async (args) => {
      const result = await searchToolHandlers.search_kin(args);
      return {
        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
      };
    }

• src/schemas/search.schemas.ts:33-41 (schema)

  Zod schema defining input parameters for search tools including search_kin (query, display, start, sort)

  export const SearchArgsSchema = z.object({
    query: z.string().describe("검색어"),
    display: z.number().optional().describe("한 번에 가져올 결과 수 (기본 10)"),
    start: z.number().optional().describe("검색 시작 위치 (기본 1)"),
    sort: z
      .enum(["sim", "date"])
      .optional()
      .describe("정렬 방식 (sim: 유사도, date: 날짜순)"),
  });

• src/clients/naver-search.client.ts:76-78 (helper)

  Core search method in NaverSearchClient that performs the actual HTTP GET request to Naver API endpoint /search/{type} where type="kin" for search_kin tool

  async search(type: NaverSearchType, params: SearchArgs): Promise<any> {
    return this.get(`${this.searchBaseUrl}/${type}`, params);
  }