网页搜索内容检索服务器

一个提供网页搜索和内容检索功能的MCP服务器,适用于AI助手等需要获取网络信息的场景。

  • by zgagnon
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 zgagnon/web-mcp

使用说明

Web MCP服务器

一种模型上下文协议(MCP)服务器,为人工智能助手提供网络搜索和内容检索功能。

特性

服务器提供两个主要工具:

  • 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 (string,必填):要执行的搜索查询
  • limit (number,可选):返回的最大结果数(默认值:10)

输出:

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

read_url

获取并返回指定URL的文本内容,同时删除HTML标记。使用Mozilla的可读性来提取有意义的内容。

输入:

  • url (string,必填):从中获取内容的URL
  • useReadabilityMode (boolean,可选):是否使用Mozilla的可读性来提取主要内容(默认值:true)
  • maxLength (数字,可选):返回内容的最大字符长度(默认值:10000)

输出:

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

错误处理

在以下情况下,服务器将返回错误:

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

实现细节

服务器使用:

  • JSDOM和Mozilla的HTML处理和内容提取可读性
  • HTTP请求的节点获取
  • Zod用于模式验证