使用说明
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,必填):从中获取内容的URLuseReadabilityMode(boolean,可选):是否使用Mozilla的可读性来提取主要内容(默认值:true)maxLength(数字,可选):返回内容的最大字符长度(默认值:10000)
输出:
- URL中的纯文本内容,可能会被截断以适应上下文窗口
错误处理
在以下情况下,服务器将返回错误:
- 向任何工具提供无效参数
- URL获取失败
- 搜索执行失败
实现细节
服务器使用:
- JSDOM和Mozilla的HTML处理和内容提取可读性
- HTTP请求的节点获取
- Zod用于模式验证
