mcpField
W
Web MCP Server

Web MCP Server

本地服务
github.com/zgagnon搜索与检索177 周前更新
代码仓库

关于 Web MCP Server

Web MCP Server 为 AI 助手提供网页搜索和页面文本获取。它结合 DuckDuckGo 搜索结果链接、URL 抓取及可选的 Mozilla Readability 正文提取。

主要功能

  1. 01DuckDuckGo 网页搜索
  2. 02可设置数量的结果链接
  3. 03获取 URL 文本内容
  4. 04基于 Readability 提取正文
  5. 05可设置内容长度

适用场景

  1. 01搜索并查找相关网页
  2. 02获取 URL 的可读文本
  3. 03限制页面内容长度以适配上下文

MCP 相关

向 MCP 客户端提供 DuckDuckGo 搜索和 URL 阅读工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "web": {
      "command": "npx",
      "args": [
        "-y",
        "https://zgagnon.com/webmcp"
      ]
    }
  }
}
启动命令npx -y https://zgagnon.com/webmcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmwebmcp

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Web MCP 服务

一个模型上下文协议（MCP）服务，为 AI 助手提供网页搜索和内容检索功能。

功能

该服务提供两个主要工具：

  • search_duckduckgo：使用 DuckDuckGo 搜索网页，并返回搜索结果的 URL
  • read_url：获取并处理 URL 中的内容，移除 HTML 标记以提高可读性

设置

# Install dependencies
npm install

# Development (with auto-reload)
npm run dev

# Production build
npm run build
npm start

本地运行

使用

npx https://zgagnon.com/webmcp

或

nix run github:zgagnon.com/webmcp

API

search_duckduckgo

使用 DuckDuckGo 搜索网页，并仅返回搜索结果的 URL。

输入：

  • query（字符串，必填）：要执行的搜索查询
  • limit（数字，可选）：要返回的最大结果数（默认值：10）

输出：

  • 与搜索查询匹配的 URL 列表
read_url

获取并返回指定 URL 的文本内容，同时移除 HTML 标记。使用 Mozilla 的 Readability 提取有意义的内容。

输入：

  • url（字符串，必填）：要获取内容的 URL
  • useReadabilityMode（布尔值，可选）：是否使用 Mozilla 的 Readability 提取主要内容（默认值：true）
  • maxLength（数字，可选）：返回内容的最大字符数（默认值：10000）

输出：

  • URL 中的纯文本内容，可能会截断以适应上下文窗口

错误处理

在以下情况下，服务会返回错误：

  • 向任何工具提供了无效参数
  • 获取 URL 失败
  • 执行搜索失败

实现细节

该服务使用：

  • JSDOM 和 Mozilla 的 Readability 处理 HTML 并提取内容
  • Node-fetch 发送 HTTP 请求
  • Zod 进行架构验证

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。