关键词

网络搜索图片搜索YouTube外部 APIAI 上下文

项目简介

SearchAPI.site MCP 服务器是一个基于 Model Context Protocol (MCP) 标准的应用后端，旨在使 AI 助手能够安全、标准地访问外部数据源，特别是通过 SearchAPI.site 提供的多种搜索服务。它将复杂的外部 API 调用封装成 MCP 规范定义的 工具（Tools），供 LLM 客户端发现和使用。

主要功能点

该 MCP 服务器提供以下核心功能作为 AI 助手可调用的工具：

  • Google 网络搜索: 执行 Google 网页搜索并返回结果。
  • Google 图片搜索: 执行 Google 图片搜索并返回结果。
  • YouTube 搜索: 执行 YouTube 视频搜索并返回结果。
  • 支持通过 'SearchAPI.site' 账号管理和调用这些搜索服务。
  • 通过 MCP 的 Stdio 传输协议与客户端通信。

安装步骤

  1. 克隆仓库: 
    git clone https://github.com/mrgoonie/searchapi-mcp-server.git
cd searchapi-mcp-server
  2. 安装依赖: 
    npm install
  3. 构建项目: 
    npm run build
    这将生成可执行的 JavaScript 文件在 'dist' 目录下。

服务器配置 (供 MCP 客户端使用)

MCP 服务器通常作为独立的进程启动，由 MCP 客户端负责管理。您需要在您的 MCP 客户端配置中指定如何启动此服务器。以下是典型的 JSON 配置示例：

{
  "mcpServers": {
    "searchapi": {
      "command": "node", // 启动 Node.js 进程
      "args": ["/path/to/searchapi-mcp-server/dist/index.js"], // 指定要执行的服务器主文件路径
      "transportType": "stdio" // 使用标准的 Stdio 传输协议
    }
  }
}

请注意:

  • 将 '"/path/to/searchapi-mcp-server/dist/index.js"' 替换为您实际克隆和构建后 'index.js' 文件的完整路径。
  • '"searchapi"' 是您为此服务器在客户端中定义的名称，可以根据需要修改。
  • 该服务器目前稳定支持 '"stdio"' 传输类型。对 '"sse"' (Server-Sent Events) 的支持正在开发中。

此外，您可能需要在服务器运行环境中配置 'SEARCHAPI_API_KEY' 环境变量或在 '~/.mcp/configs.json' 文件中配置您的 SearchAPI.site API 密钥，以便服务器能够调用 SearchAPI.site 的服务。

基本使用方法 (通过 MCP 客户端)

一旦在您的 MCP 客户端中配置并成功启动了 SearchAPI.site MCP 服务器，AI 助手将能够自动发现服务器注册的工具。AI 可以通过调用这些工具来执行搜索操作。

例如，AI 可能会通过 MCP 协议向服务器发送一个 JSON-RPC 请求来调用 'search_google' 工具，传递必要的参数（如 'query' 和可选的 'apiKey'）：

{
  "jsonrpc": "2.0",
  "method": "tool/call",
  "params": {
    "tool": "search_google",
    "args": {
      "query": "MCP protocol specification",
      "apiKey": "YOUR_SEARCHAPI_API_KEY"
    }
  },
  "id": "some-unique-id"
}

服务器接收请求，执行搜索，然后返回包含 Markdown 格式搜索结果的 JSON-RPC 响应。AI 助手会解析此响应并在对话中使用搜索结果。

同样，AI 可以调用 'search_google_images' 或 'search_youtube' 工具，提供相应的 'query' 和其他参数。

信息

分类

网页与API

访问项目