关键词

网页搜索AI工具成本节约信息检索OpenAI

使用说明

项目简介

本项目是一个轻量级的MCP（Model Context Protocol）服务器，旨在为支持MCP协议的AI客户端（如Cursor AI, Claude等）提供便捷的网页搜索功能。它利用OpenAI的 'gpt-4o-mini-search-preview' 模型 或 OpenRouter.ai 提供的类似模型，允许用户通过简单的指令让AI进行网页搜索，并将搜索结果作为上下文信息提供给AI，从而增强AI的知识检索和问题解决能力。

主要优点:

  • 节省成本: 使用成本较低的 '4o-mini-search' 模型进行搜索，相较于昂贵的LLM token消耗，大幅降低搜索成本。
  • 快速集成: 通过简单的 'npx' 命令即可启动，配置过程非常简便。
  • 广泛兼容: 兼容多种MCP客户端，如 Claude, Cursor AI, Windsurf 等。
  • 灵活API: 支持 OpenAI 和 OpenRouter.ai 两种服务提供商。

主要功能点

  • 网页搜索工具: 提供 'search' 工具，允许AI客户端调用进行网页搜索。
  • 低成本搜索: 使用经济高效的 '4o-mini-search' 模型，降低搜索成本。
  • 多服务商支持: 可配置使用 OpenAI 或 OpenRouter.ai 的服务。
  • 标准MCP协议: 遵循 MCP 协议，易于与各种 MCP 客户端集成。

安装步骤

  1. 确保已安装 Node.js 和 npm (或 npx): 本服务基于 Node.js 运行，请确保您的环境中已安装 Node.js 和 npm 包管理器。通常 Node.js 安装包会自带 npm，npx 通常也随 npm 一起安装。

  2. 无需手动安装: 本项目以 npm 包的形式发布，您无需手动下载或构建代码，可以直接通过 'npx' 命令运行。

服务器配置

MCP客户端需要配置服务器连接信息才能使用 '4o-mini-search-mcp' 服务。以下是配置示例，请添加到您的MCP客户端的配置文件中（通常是 JSON 格式）。

{
  "mcpServers": {
    "4o-mini-search": {  // 服务器名称，可以自定义，用于在客户端中标识
      "command": "npx",  // 启动服务器的命令，这里使用 npx 运行 npm 包
      "args": ["@rebers/4o-mini-search-mcp"], // 命令参数，指定要运行的 npm 包名称
      "env": { // 环境变量配置
        "API_KEY": "your-api-key",  //  **必需配置**：您的 OpenAI 或 OpenRouter.ai  API 密钥，请替换为您的实际密钥
        "PROVIDER": "openai"  // **可选配置**：服务提供商，默认为 "openai"。 可选 "openrouter" 以使用 OpenRouter.ai。
      }
    }
  }
}

配置参数说明:

  • '"4o-mini-search"': 服务器名称，您可以自定义，用于在 MCP 客户端中引用和管理该服务器连接。
  • '"command": "npx"': 指定启动服务器的命令为 'npx'，它会查找并执行 npm 包。
  • '"args": ["@rebers/4o-mini-search-mcp"]': 'npx' 命令的参数，指定要执行的 npm 包为 '@rebers/4o-mini-search-mcp'。 这会自动下载并运行该 MCP 服务器。
  • '"env": { ... }': 配置环境变量，服务器运行时会读取这些环境变量。
    • '"API_KEY": "your-api-key"': 必须替换 为您从 OpenAI 或 OpenRouter.ai 获取的 API 密钥。这是访问搜索服务的凭证。
    • '"PROVIDER": "openai"': 可选配置，指定服务提供商。
      • '"openai"' (默认值): 使用 OpenAI 官方的 'gpt-4o-mini-search-preview' 模型。
      • '"openrouter"': 使用 OpenRouter.ai 提供的 'openai/gpt-4o-mini-search-preview' 模型。 如果您希望通过 OpenRouter.ai 访问，请设置为 '"openrouter"'。

重要提示:

  • API 密钥安全: 请妥善保管您的 API 密钥，避免泄露。
  • 环境变量配置: MCP客户端通常允许您在配置文件中设置环境变量。请根据您的客户端文档找到正确的配置文件位置并进行配置。
  • 重启客户端: 修改 MCP 配置文件后，您需要重启您的 MCP 客户端（如 Cursor AI, Claude 等）以使配置生效。

基本使用方法

配置完成后，在您的 MCP 客户端中，您可以使用类似以下的指令来触发网页搜索：

search mcp for 最新 3.7 模型以及如何与 node sdk 一起使用
search mcp for nextjs app router 的工作原理以及如何使用它
search mcp for 最新的 sveltekit 模板

您的 AI 客户端会将 'search mcp for ...' 识别为对 MCP 服务器的 'search' 工具的调用，并将搜索关键词发送到 '4o-mini-search-mcp' 服务器。服务器会执行网页搜索，并将搜索结果返回给您的 AI 客户端，作为上下文信息供 AI 使用。

示例: 在 Cursor AI 中，您可以直接在聊天框中输入 'search mcp for ...' 这样的指令，Cursor AI 会自动调用配置的 MCP 服务器进行搜索，并将结果展示给您。

通过 '4o-mini-search-mcp'，您可以轻松为您的 AI 客户端添加强大的网页搜索能力，提升其信息获取和处理能力，同时有效控制成本。

信息

分类

网页与API

访问项目