关键词

网页搜索新闻搜索网站抓取sitemap推理

Search1API MCP Server 使用说明

项目简介

Search1API MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，旨在为大型语言模型 (LLM) 客户端提供丰富的上下文信息和实用工具。它集成了 Search1API 服务，能够进行网页搜索、新闻检索、抓取网页内容、提取网站 Sitemap 以及进行基于 DeepSeek R1 模型的推理。

主要功能点

  • 网页搜索: 使用 Search1API 强大的搜索功能，快速检索互联网信息。
  • 新闻搜索: 专门搜索新闻资讯，获取最新的新闻报道。
  • 网页内容抓取: 提取指定 URL 的网页内容，方便 LLM 理解网页信息。
  • 网站 Sitemap 提取: 获取网站的 Sitemap 链接，帮助 LLM 更好地了解网站结构。
  • 推理工具: 集成 DeepSeek R1 模型，提供深度思考和复杂问题解决能力。

安装步骤

  1. 获取 Search1API Key:
  2. 安装 Search1API MCP Server:
    • 确保已安装 Node.js 和 npm。
    • 打开终端，克隆仓库或下载代码。
    • 进入项目根目录，运行命令安装依赖： 
      npm install
  3. 配置环境变量:
    • 在项目根目录下创建 '.env' 文件。
    • 在 '.env' 文件中添加您的 Search1API Key： 
      SEARCH1API_KEY=YOUR_SEARCH1API_KEY

服务器配置

要将 Search1API MCP Server 集成到 MCP 客户端（如 Claude Desktop, Cursor, Windsurf），您需要配置 MCP 服务器信息。以下是针对不同客户端的配置示例，您只需将配置信息复制到客户端的配置文件中即可。请注意替换 'YOUR_SEARCH1API_KEY' 为您实际的 API Key。

Claude Desktop 配置

在 Claude Desktop 的配置文件 'claude_desktop_config.json' 中添加以下 'mcpServers' 配置：

{
  "mcpServers": {
    "search1api": {
      "command": "npx",
      "args": ["-y", "search1api-mcp"],
      "env": {
        "SEARCH1API_KEY": "YOUR_SEARCH1API_KEY"
      }
    }
  }
}
  • 'server name': 'search1api' (服务器名称，客户端内唯一标识即可)
  • 'command': 'npx' (启动命令，用于执行 npm 包)
  • 'args': '["-y", "search1api-mcp"]' (命令参数，'-y' 表示自动确认安装，'search1api-mcp' 是要执行的 npm 包名)
  • 'env': 环境变量配置
    • 'SEARCH1API_KEY': 'YOUR_SEARCH1API_KEY' (Search1API 的 API 密钥，请替换为您的真实密钥)

Cursor 配置

在 Cursor 设置中添加 MCP 服务器，配置命令如下：

env SEARCH1API_KEY=YOUR_SEARCH1API_KEY npx -y search1api-mcp

或使用 'run.sh' 脚本（更安全的方式）：

  1. 复制 'run.template.sh' 并重命名为 'run.sh'。
  2. 修改 'run.sh' 文件，填入您的 Search1API Key。
  3. 在 Cursor 设置中配置命令为： 'sh ./your_file_path/run.sh' （'your_file_path' 为 'run.sh' 脚本的路径）。
  • 'server name': 'search1api' (服务器名称，客户端内唯一标识即可)
  • 'command': 'env' (启动命令，用于设置环境变量并执行后续命令)
  • 'args': '["SEARCH1API_KEY=YOUR_SEARCH1API_KEY", "npx", "-y", "search1api-mcp"]' (命令参数，'SEARCH1API_KEY=YOUR_SEARCH1API_KEY' 设置环境变量，'npx -y search1api-mcp' 执行服务器)
  • 环境变量：通过命令行 'env' 设置，无需额外配置

Windsurf 配置

在 Windsurf 的配置文件 'mcp_config.json' 中添加以下 'mcpServers' 配置：

{
  "mcpServers": {
    "search1api": {
      "command": "npx",
      "args": ["-y", "search1api-mcp"],
      "env": {
        "SEARCH1API_KEY": "YOUR_SEARCH1API_KEY"
      }
    }
  }
}
  • 'server name': 'search1api' (服务器名称，客户端内唯一标识即可)
  • 'command': 'npx' (启动命令，用于执行 npm 包)
  • 'args': '["-y", "search1api-mcp"]' (命令参数，'-y' 表示自动确认安装，'search1api-mcp' 是要执行的 npm 包名)
  • 'env': 环境变量配置
    • 'SEARCH1API_KEY': 'YOUR_SEARCH1API_KEY' (Search1API 的 API 密钥，请替换为您的真实密钥)

基本使用方法

  1. 启动 Search1API MCP Server：在项目根目录终端运行 'npm start' 或直接使用客户端配置中的启动命令。
  2. 在支持 MCP 协议的 LLM 客户端（如 Claude Desktop, Cursor, Windsurf）中配置并启用 Search1API MCP Server。
  3. 在 LLM 对话中使用工具：在 LLM 客户端中，您可以通过自然语言指令调用服务器提供的工具，例如：
    • 使用 'search' 工具进行网页搜索，例如 "搜索最新的AI技术发展"。
    • 使用 'news' 工具搜索新闻，例如 "查找今天关于气候变化的新闻"。
    • 使用 'crawl' 工具抓取网页内容，例如 "抓取 https://example.com 的内容"。
    • 使用 'sitemap' 工具获取网站地图，例如 "获取 https://example.com 的站点地图"。
    • 使用 'reasoning' 工具进行推理，例如 "分析一下电动汽车的未来发展趋势"。
  4. LLM 客户端会将您的指令转换为 MCP 请求发送给 Search1API MCP Server，服务器处理请求后将结果返回给 LLM 客户端，从而增强 LLM 的上下文理解和功能扩展。

信息

分类

网页与API

访问项目