wisper (Liut)

Webpawm

Webpawm是一个MCP（模型上下文协议）服务器，它提供具有多个搜索引擎支持的网络搜索功能。

特性

• 多个搜索引擎：支持SearXNG、谷歌、必应、Brave、必应中国（中国）和Arxiv
• 多种运输方式:

- HTTP/SSE模式（通过 webpawm web 命令） - 标准模式（通过 webpawm 或 webpawm std 命令）

• 统一搜索：单人 web_search 具有智能默认值的工具（多引擎、查询扩展、重复数据删除）
• 灵活的配置：支持配置文件（~/.webpawm/config.json）和环境变量
• 访问日志记录：内置基于slog的HTTP访问日志
• API密钥验证：HTTP端点的可选API密钥保护（X-API-key或Bearer令牌）

安装

go install github.com/liut/webpawm@latest

或者从源代码构建：

git clone https://github.com/liut/webpawm.git
cd webpawm
make main
install dist/webpawm /usr/local/bin/

用法

标准模式（默认）

作为本地MCP工具运行：

webpawm

HTTP/SSE模式

启动web服务器（使用可选的API密钥身份验证）：

webpawm web --listen localhost:8087

服务器提供两个端点：

• HTTP： http://localhost:8087/mcp
• 上海证券交易所 http://localhost:8087/mcp/sse

使用URI前缀：

webpawm web --listen localhost:8087 --uri-prefix /api

端点变为：

• HTTP： http://localhost:8087/api/mcp
• 上海证券交易所 http://localhost:8087/api/mcp/sse

认证

当 api_key 在配置文件中配置或 WEBPAWM_API_KEY 环境变量，HTTP端点需要身份验证。

请求与 X-API-Key 头球

curl -H "X-API-Key: your-secret-key" http://localhost:8087/mcp

或与 Authorization: Bearer 头球

curl -H "Authorization: Bearer your-secret-key" http://localhost:8087/mcp

MCP工具

Webpawm提供两个MCP工具：

网络搜索

具有智能默认值的统一搜索工具。支持单引擎、多引擎并行搜索和具有重复数据删除功能的自动查询扩展。

备注: engine 和 engines 支持枚举值-工具模式中列出了可用的引擎。

web_fetch

获取一个网站，并通过HTML到Markdown的转换返回其内容。

配置

配置文件

创建 ~/.webpawm/config.json:

{
  "searchxng_url": "https://searchx.ng",
  "google_api_key": "your-api-key",
  "google_cx": "your-search-engine-id",
  "bing_api_key": "your-bing-api-key",
  "brave_api_key": "your-brave-api-key",
  "api_key": "your-api-key",
  "max_results": 10,
  "default_engine": "searchxng",
  "listen_addr": "localhost:8087",
  "uri_prefix": "",
  "log_level": "info"
}

环境变量

优先

配置优先级（从高到低）：

1. 命令行标志
2. 环境变量
3. 配置文件
4. 默认值

许可证

麻省理工学院