使用说明

项目简介

Jina AI Search MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器,旨在为大型语言模型 (LLM) 提供便捷的网络搜索能力。它通过 Jina.ai Search API 高效地检索和提取网页内容,并将结果以 LLM 友好的格式返回,作为 LLM 的上下文信息,增强 LLM 的知识和应用能力。

主要功能点

  • 网页搜索: 利用 Jina.ai Search API 执行高级网页搜索。
  • 内容提取: 从搜索结果中提取干净、结构化的文本内容。
  • LLM 优化: 提取的内容针对 LLM 进行了优化,更易于理解和处理。
  • 可配置参数: 支持多种参数配置,如缓存控制、token 预算、本地化、流式传输等,满足不同的搜索需求。
  • MCP 协议: 基于标准的 Model Context Protocol 构建,易于集成到各种 MCP 客户端。

安装步骤

  1. 克隆仓库
    git clone https://github.com/spences10/mcp-jinaai-search
    cd mcp-jinaai-search
  2. 安装依赖 确保已安装 pnpm。如果使用 npm 或 yarn,请替换相应的命令。
    pnpm install
  3. 构建项目
    pnpm run build

服务器配置

将以下 JSON 配置添加到您的 MCP 客户端(例如 Cline 或 Claude Desktop)的 MCP 服务器配置中。您需要将 'YOUR_JINAAI_API_KEY' 替换为您在 Jina.ai 申请的 API 密钥。

{
  "mcpServers": {
    "jinaai-search": {
      "command": "node",
      "args": ["-y", "mcp-jinaai-search"],
      "env": {
        "JINAAI_API_KEY": "YOUR_JINAAI_API_KEY"
      }
    }
  }
}
  • 'server name': 'jinaai-search' (服务器名称,可以自定义,用于在 MCP 客户端中标识和调用)
  • 'command': 'node' (运行服务器的命令,这里使用 Node.js)
  • 'args': '["-y", "mcp-jinaai-search"]' (命令参数,'-y' 表示自动确认,'mcp-jinaai-search' 是服务器入口脚本)
  • 'env': 环境变量配置
    • 'JINAAI_API_KEY': 必填。您的 Jina.ai API 密钥,用于访问 Jina.ai Search API。请前往 Jina.ai 官网 获取。

基本使用方法

  1. 启动服务器: 配置完成后,当 MCP 客户端尝试连接 'jinaai-search' 服务器时,会自动启动该服务器。通常无需手动启动,客户端会自动管理。

  2. 在 LLM 中使用 'search' 工具: 在支持 MCP 协议的 LLM 应用中,您可以调用名为 'search' 的工具来进行网页搜索。工具的具体参数请参考仓库的 'README.md' 文档或 'src/index.ts' 中的 'search_tool_schema' 定义。

    例如,在 Cline 客户端中,您可以在 Prompt 中使用类似 '@工具名(参数)' 的语法来调用 'search' 工具,例如:

    请搜索一下今天的天气怎么样 @search(query="今天天气")

    LLM 将会调用 Jina AI Search MCP Server 的 'search' 工具,并将搜索结果作为上下文信息用于生成回复。

信息

分类

网页与API