MCP Web Search Tool

MCP Web Search Tool

site icon
2025.03.08 3
TypeScript实时搜索AI助手集成网络信息检索搜索工具开发效率
MCP Web Search Tool 是一个基于 Model Context Protocol (MCP) 的服务,提供实时网络搜索功能。它通过可插拔的搜索提供商(如 Brave Search API)为 AI 助手提供最新的网络信息。该工具具有模块化架构,支持多种搜索引擎,并能以结构化的 JSON 格式返回搜索结果。
View on GitHub

Overview

✨ 核心功能

  • 实时信息获取:使 AI 助手能够从网络获取最新信息
  • 可插拔搜索提供商:模块化架构允许轻松切换不同的搜索引擎
  • 结构化输出格式:以干净、一致的 JSON 格式返回搜索结果
  • 智能查询处理:自动分类查询并为 AI 助手提供上下文感知指导

📋 适用场景

  • 天气查询
  • 当前事件和新闻
  • 体育比分和结果
  • 股票市场和金融数据
  • 时间敏感信息
  • 一般信息查询

🛠️ 可用工具

Web Search

  • 工具名称: web_search
  • 描述: 搜索网络获取实时信息
  • 适用场景: 天气、当前事件、体育比分、股票市场更新
  • 参数:
  • search_term (string): 要查找的搜索词
  • provider (string, optional): 搜索提供商(默认为 Brave)

🚀 安装教程

使用依赖

  • Node.js: v16.x 或更新版本
  • npm: v7.x 或更新版本
  • Brave Search API Key: 访问 Brave Search API 所需

安装步骤

  1. 克隆仓库: bash git clone https://github.com/gabrimatic/mcp-web-search-tool.git cd mcp-web-search-tool

  2. 安装依赖: bash npm install

  3. 配置环境变量: 在项目根目录创建 .env 文件: BRAVE_API_KEY=your_api_key_here MAX_RESULTS=10 # 可选: 默认为 10 REQUEST_TIMEOUT=10000 # 可选: 默认为 10000ms

  4. 构建项目: bash npm run build

💻 调试方式

启动服务器

npm start

测试服务器

node test-server.js

常见问题解答

  • 如何获取 Brave Search API Key? 访问 Brave Search API Dashboard 获取 API Key。

  • 如何集成到 Claude Desktop App? 创建 claude_desktop_config.json 文件并配置 MCP 服务器路径。

  • 支持哪些搜索引擎? 目前主要支持 Brave Search,但架构设计支持添加更多搜索引擎。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。