使用说明

项目简介

Search1API MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 客户端提供强大的网络信息访问能力。它集成了 Search1API 服务，通过 MCP 协议将网页搜索、新闻搜索、网页内容抓取和站点地图提取等功能以标准化的方式提供给 LLM 客户端，例如 Claude Desktop。

主要功能点

网页搜索: 使用 'search' 工具，根据关键词在网络上搜索信息。
新闻搜索: 使用 'news' 工具，快速查找最新的新闻报道。
网页抓取: 使用 'crawl' 工具，提取指定 URL 网页的内容。
站点地图提取: 使用 'sitemap' 工具，获取网站的站点地图链接列表。
与 Claude Desktop 无缝集成: 提供详细的 Claude Desktop 配置文件示例，方便用户快速集成。

安装步骤

克隆仓库

git clone https://github.com/MCP-Mirror/fatwang2_search1api-mcp.git
cd fatwang2_search1api-mcp

安装依赖 确保已安装 Node.js 和 npm。在项目根目录下运行：
```
npm install
```
获取 Search1API Key
- 访问 Search1API 注册账号。
- 选择合适的付费计划（最低 $0.99 起）。
- 完成支付后，在确认邮件中找到您的 API Key 并复制。

配置环境变量 创建或修改项目根目录下的 '.env' 文件，添加您的 Search1API Key：

SEARCH1API_KEY=YOUR_SEARCH1API_KEY  # 将 YOUR_SEARCH1API_KEY 替换为您的 API Key

启动 MCP 服务器 在项目根目录下运行以下命令启动服务器：
```
npm start
```
服务器默认通过标准输入输出 (stdio) 与 MCP 客户端通信。

服务器配置

要将此 MCP 服务器与 MCP 客户端（例如 Claude Desktop）连接，您需要在客户端的配置文件中添加服务器配置信息。以下是针对 Claude Desktop 的 'claude_desktop_config.json' 配置文件示例：

{
  "mcpServers": {
    "search1api": {  // 服务器名称，可以自定义
      "command": "npx", // 启动服务器的命令，这里使用 npx 执行本地 node_modules 中的 search1api-mcp 包
      "args": ["-y", "search1api-mcp"], // 传递给命令的参数，-y 参数用于跳过 npx 的安装确认
      "env": {
        "SEARCH1API_KEY": "YOUR_SEARCH1API_KEY" // 环境变量，Claude Desktop 会将其传递给 MCP 服务器进程
      }
    }
  }
}

配置参数说明:

'server name' (search1api): 为您的 MCP 服务器指定一个名称，客户端将使用此名称来引用服务器。您可以自定义此名称。
'command' (npx): 指定用于启动 MCP 服务器的命令。'npx' 允许您执行本地安装的 npm 包。
'args' (["-y", "search1api-mcp"]): 传递给 'command' 的参数。'"-y"' 是 'npx' 的参数，用于自动确认安装包（如果尚未安装）。 '"search1api-mcp"' 是 'package.json' 中 'bin' 字段定义的、指向服务器入口文件 'src/index.ts' 的可执行文件名。
'env': 一个 JSON 对象，用于设置 MCP 服务器运行时的环境变量。'SEARCH1API_KEY' 用于传递您的 Search1API 密钥，请务必替换为您的实际 API Key。

Claude Desktop 配置文件路径:

macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%\Claude\claude_desktop_config.json'

基本使用方法

配置完成后，当 MCP 客户端（如 Claude Desktop）连接到此 MCP 服务器后，您可以使用以下工具来扩展 LLM 的能力：

search: 进行网页搜索。例如，在 Claude 中，您可以指示其 "使用 'search' 工具搜索关于[主题]的信息"。工具参数包括 'query' (必填，搜索关键词)、'max_results' (可选，返回结果数量，默认 10) 和 'search_service' (可选，搜索引擎，默认 "google")。
news: 搜索新闻。例如，指示 "使用 'news' 工具查找关于[关键词]的新闻报道"。工具参数与 'search' 工具类似。
crawl: 抓取网页内容。例如，指示 "使用 'crawl' 工具抓取 [URL] 的内容"。工具参数为 'url' (必填，网页 URL)。
sitemap: 获取站点地图。例如，指示 "使用 'sitemap' 工具获取 [URL] 的站点地图链接"。工具参数为 'url' (必填，网站 URL)。

LLM 客户端会根据工具的描述和参数信息，生成 JSON-RPC 请求发送给 MCP 服务器，服务器执行相应的操作并将结果返回给客户端。

关键词