使用说明

项目简介

Naver Search MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在通过工具的形式向 LLM 应用提供对 Naver 搜索 API 和 DataLab API 的访问能力。它允许 LLM 客户端调用各种 Naver 搜索服务（如网页、新闻、博客、购物等）以及数据趋势分析功能，从而增强 LLM 在处理韩国相关信息时的上下文理解和信息检索能力。

主要功能点

多样的Naver搜索工具: 提供全面的 Naver 搜索功能，包括网页搜索、新闻搜索、博客搜索、购物搜索、图片搜索、知识问答搜索、图书搜索、百科搜索、学术搜索和本地信息搜索，满足各种信息检索需求。
强大的Naver DataLab工具: 集成 Naver DataLab API，支持搜索趋势分析、购物分类趋势分析、设备/性别/年龄段购物趋势分析、关键词购物趋势分析等多种数据分析功能，帮助用户深入了解韩国市场和用户行为。
标准化的MCP协议: 遵循 Model Context Protocol (MCP) 协议，通过 JSON-RPC 与 MCP 客户端进行通信，提供标准化的工具调用接口，易于集成到各种支持 MCP 协议的 LLM 应用中。
便捷的安装和配置: 提供多种安装方式，包括 Smithery 一键安装、手动安装和 Docker 部署，并提供详细的配置说明和示例，方便用户快速部署和使用。
Stdio传输协议: 默认使用 Stdio 传输协议，易于集成到命令行或后台进程运行的 LLM 应用中。

安装步骤

获取 Naver Developer API 密钥:
- 访问 Naver Developers 注册应用并获取 Client ID 和 Client Secret。
- 务必选择以下API:
  - Search (用于博客、新闻、图书搜索等)
  - DataLab (Search Trends)
  - DataLab (Shopping Insight)
- 将获取的 Client ID 和 Client Secret 设置为环境变量 'NAVER_CLIENT_ID' 和 'NAVER_CLIENT_SECRET'。

选择安装方式 (以下任选一种):

Option 1: 使用 Smithery (推荐，简化安装)
- 根据你的 LLM 客户端类型，运行相应的 'npx' 命令。例如，对于 Claude Desktop 客户端：
```
npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client claude
```
- 安装程序将提示你输入 'NAVER_CLIENT_ID' 和 'NAVER_CLIENT_SECRET'。

Option 2: 手动安装

确保已安装 Node.js 18 或更高版本，以及 NPM 8 或更高版本。

设置环境变量:

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

运行服务器:

npx @modelcontextprotocol/server-naver-search

Option 3: 使用 Docker

确保已安装 Docker。

运行 Docker 容器:

docker run -i --rm \
  -e NAVER_CLIENT_ID=your_client_id \
  -e NAVER_CLIENT_SECRET=your_client_secret \
  mcp/naver-search

服务器配置

MCP 客户端需要配置 MCP 服务器的启动命令才能连接到 Naver Search MCP Server。以下是针对不同启动方式的 MCP 客户端配置示例 (JSON 格式)。你需要将这些配置添加到你的 MCP 客户端配置文件中。

NPX 启动配置示例:
```
{
  "serverName": "naver-search",
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-naver-search"]
}
```
参数说明:
- 'serverName': 服务器名称，用于在客户端中标识和引用。可以自定义，例如 "naver-search"。
- 'command': 启动服务器的命令，这里使用 'npx'。
- 'args': 传递给 'command' 的参数数组，'-y' 自动确认安装，'@modelcontextprotocol/server-naver-search' 是服务器的 npm 包名。

Docker 启动配置示例:

{
  "serverName": "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"
  ]
}

参数说明:

'serverName': 服务器名称，例如 "naver-search"。
'command': 启动服务器的命令，这里使用 'docker'。
'args': 传递给 'command' 的参数数组，包括 'docker run' 命令及其参数：
- '-i': 保持标准输入 (STDIN) 打开。
- '--rm': 容器退出后自动删除。
- '-e NAVER_CLIENT_ID=your_client_id': 设置环境变量 'NAVER_CLIENT_ID'，请替换为你的 Client ID。
- '-e NAVER_CLIENT_SECRET=your_client_secret': 设置环境变量 'NAVER_CLIENT_SECRET'，请替换为你的 Client Secret。
- 'mcp/naver-search': Docker 镜像名称。

重要: 请务必将 'your_client_id' 和 'your_client_secret' 替换为你从 Naver Developer 网站获取的实际 API 密钥。

基本使用方法

MCP 客户端成功连接到 Naver Search MCP Server 后，你可以通过客户端提供的界面或 API 调用以下工具来使用 Naver 搜索和 DataLab 功能：

搜索工具:
- 'search_webkr': 搜索 Naver 网页文档
- 'search_news': 搜索 Naver 新闻
- 'search_blog': 搜索 Naver 博客
- 'search_shop': 搜索 Naver 购物信息
- 'search_image': 搜索 Naver 图片
- 'search_kin': 搜索 Naver 知识iN
- 'search_book': 搜索 Naver 图书
- 'search_encyc': 搜索 Naver 百科全书
- 'search_academic': 搜索 Naver 学术资料
- 'search_local': 搜索 Naver 本地信息 (地点)
使用这些工具时，你需要提供 'query' 参数作为搜索关键词。其他可选参数 (如 'display', 'start', 'sort') 请参考工具的具体描述和参数定义。
DataLab 工具:
- 'datalab_search': 分析搜索词的趋势
- 'datalab_shopping_category': 分析购物类别的趋势
- 'datalab_shopping_by_device': 分析设备类型 (PC/移动) 的购物趋势
- 'datalab_shopping_by_gender': 分析性别的购物趋势
- 'datalab_shopping_by_age': 分析年龄段的购物趋势
- 'datalab_shopping_keywords': 分析购物关键词的趋势
- 'datalab_shopping_keyword_by_device': 分析设备类型的购物关键词趋势
- 'datalab_shopping_keyword_by_gender': 分析性别的购物关键词趋势
- 'datalab_shopping_keyword_by_age': 分析年龄段的购物关键词趋势
使用 DataLab 工具时，你需要根据具体工具的要求提供相应的参数，例如日期范围 ('startDate', 'endDate')、时间单位 ('timeUnit')、类别 ('category')、关键词 ('keyword') 等。具体参数定义请参考工具的 'inputSchema'。

示例: 使用 'search_news' 工具搜索 "最新韩国新闻"：
```
{
  "tool_calls": [
    {
      "id": "search-news-1",
      "type": "function",
      "function": {
        "name": "search_news",
        "arguments": {
          "query": "最新韩国新闻"
        }
      }
    }
  ]
}
```
请查阅 MCP 客户端的文档以了解如何配置和使用 MCP 服务器以及如何调用工具。

关键词