Webtools MCP Server

Webtools MCP Server

**摘要：** Webtools MCP Server 是一个用于网页抓取、HTML提取和Markdown转换的MCP兼容工具，支持JavaScript渲染和代理。

GitHub
Created Bymisterboemisterboe

简介

Webtools MCP 服务器提供全面的网页分析工具，包括HTML提取、Markdown转换、截图功能、调试控制台和基于Lighthouse的网页审核。

⚠️ 免责声明：此软件按原样提供，仅供研究和学习使用，不建议用于生产环境。

安装

# 全局安装
npm install -g @bschauer/webtools-mcp-server

# 或使用npx运行
npx @bschauer/webtools-mcp-server

Claude Desktop 集成

将以下内容添加到Claude Desktop配置中：

{
  "mcpServers": {
    "webtools": {
      "command": "npx",
      "args": ["-y", "@bschauer/webtools-mcp-server@latest"]
    }
  }
}

主要功能

HTML 内容提取

webtool_gethtml({
  url: "https://example.com",
  useJavaScript: true,
  useProxy: false
});

Markdown 转换

webtool_readpage({
  url: "https://example.com",
  useJavaScript: true,
  selector: "main"
});

截图捕捉

webtool_screenshot({
  url: "https://example.com",
  selector: ".content",
  deviceConfig: {
    width: 1920,
    height: 1080,
    isMobile: false
  }
});

调试控制台

webtool_debug({
  url: "https://example.com",
  captureConsole: true,
  captureNetwork: true,
  timeoutMs: 5000
});

网页审核

webtool_lighthouse({
  url: "https://example.com",
  categories: ["performance", "accessibility", "seo"],
  device: "mobile"
});

配置

创建配置文件：~/.mcp/webtools-mcp-server.config.json

{
  "proxy": {
    "enabled": false,
    "url": "http://your-proxy-server:port",
    "timeout": 10000
  },
  "browser": {
    "ignoreSSLErrors": false,
    "defaultViewport": {
      "width": 1920,
      "height": 1080
    }
  }
}

故障排除提示

  • 连接问题：检查URL格式或启用代理
  • 内容缺失：增加超时时间或检查JavaScript错误
  • 空白截图：确保选择器正确，增加视口大小
  • 审核超时：减少类别或使用更快连接

最佳实践

  1. 先从基本HTML检索开始，再尝试高级功能
  2. 仅在必要时使用JavaScript渲染（更慢但更完整）
  3. 使用选择器针对特定页面部分以提高效率
  4. 只指定需要的Lighthouse审核类别
  5. 使用调试工具识别页面加载问题

更多信息

完整文档和更新日志请参见项目GitHub仓库。