MCP Web Search Tool

MCP网络搜索工具

一 主控程序 服务器，为助手提供实时网络搜索、整页阅读和源引用。Stdio传输，可插拔提供程序，无刮刀依赖。

Claude Desktop Example

  ](https://nodejs.org)

快速启动 · 工具 · 配置 · 客户 · 安全 · 更新日志

______________________________________________________________________

概述

五种工具： web_search, news_search, image_search, fetch_url, list_providers搜索返回具有稳定ID的排名摘要； fetch_url 读取任何id后面的页面。Brave Search是主要提供商；DuckDuckGo在没有钥匙的情况下运行作为后备。

需求

快速启动

git clone https://github.com/gabrimatic/mcp-web-search-tool.git
cd mcp-web-search-tool
npm install
cp .env.example .env   # edit BRAVE_API_KEY if you have one
npm run build
npm start

使用Docker运行：

docker build -t mcp-web-search .
docker run --rm -i -e BRAVE_API_KEY mcp-web-search

有关Claude Desktop、Claude Code、Codex、VS Code、Cursor或Windsurf集成，请参阅 MCP_CLIENTS.md.

______________________________________________________________________

工具

每个工具返回两个内容块：模型的Markdown渲染和带有结构化有效载荷的围栏JSON块。错误返回为 isError: true 包含可操作信息的内容；只有未知的工具调用才会抛出协议错误。

web_search

实时网络搜索。首先使用当前的、有来源支持的答案。

news_search

最近的新闻，包括来源名称和发布日期。只有勇敢。

image_search

带有缩略图的图像结果。只有勇敢。

fetch_url

读取搜索结果或任意 http(s) URL。传递之前搜索的结果id（首选）或完整URL。

返回页面标题、可读文本（脚本、样式、导航、页脚和侧边栏）、前25个出站链接、HTTP状态、内容类型、字节长度和 nextCursor 当被截断时。

拒绝不-http(s) 方案以及解析为私有、环回、链路本地、多播或IPv4映射的IPv6私有地址的任何主机。细节： SECURITY.md.

list_providers

返回已注册的提供程序和当前默认值。如果您不确定是否 news_search 或 image_search 在本次会议中可用。

______________________________________________________________________

配置

所有配置都是环境驱动的。参考： .env.example.

______________________________________________________________________

项目布局

src/
├── index.ts                    MCP server: tool registry, dispatch, rendering
├── config.ts                   env loader, validation, defaults
├── providers/
│   ├── SearchProvider.ts       abstract contract and shared types
│   ├── SearchProviderFactory   registry and default selection
│   ├── BraveSearchProvider     web/news/images via Brave API
│   └── DuckDuckGoProvider      keyless HTML-lite fallback
├── services/
│   ├── SearchService.ts        provider dispatch, LRU+TTL cache
│   └── FetchService.ts         safe URL fetch, readable extraction
└── utils/
    ├── http.ts                 native fetch, retry/backoff/timeout
    ├── html.ts                 zero-dep HTML to text + links
    ├── cache.ts                LRU+TTL cache
    └── ids.ts                  stable result-id minting and resolution
tests/                          vitest suite

添加提供者

import { SearchProvider, SearchResponse, SearchOptions } from './SearchProvider.js';

export class MyProvider extends SearchProvider {
  getName() { return 'My Provider'; }
  override requiresApiKey() { return true; }
  async search(query: string, _opts: SearchOptions = {}): Promise {
    const out = this.emptyResponse(query, 'web');
    out.results = mapped; // shape: SearchResult[]
    return out;
  }
}

在中注册 SearchProviderFactory.setupDefaults.调用时会自动生成结果ID mintResultId(url) 在每个条目上。

______________________________________________________________________

发展

npm run dev          # tsx watch mode
npm test             # vitest (23 tests)
npm run lint
npm run format
npm run build

CI在Node 20、22和24上运行，以及Docker镜像构建。测试涵盖了LRU+TTL缓存、HTML提取器、DuckDuckGo解析器、搜索服务缓存、HTTP重试/回退、SSRF保护、域匹配和结果id解析器。

______________________________________________________________________

示例提示

• _“分析人士对今晚NBA比赛后的MVP争夺战有什么看法？”_
• _“总结以下三个结果 RAG benchmarks 2025 并从第一篇论文中提取摘要。"_
• _“找到韦伯望远镜最新深场的图像，然后打开美国国家航空航天局页面并引用标题。”_
• _“柏林现在的天气怎么样？”_

______________________________________________________________________

许可证

MIT许可证

开发者

靠近 索鲁什·优素福·普尔

©保留所有权利。

YouTube视频

带Claude的MCP Web搜索工具的简短演示：

Claude+MCP网络搜索–现场演示

中型文章

项目背景及其工作原理：

深入了解MCP网络搜索工具

支持