SuperAPI AI 工具集

page2ai-mcp

page2ai-mcp 是一个 MCP 服务器,可将任意网页 URL 转换为干净的 Markdown,供 LLM 作为上下文使用。它在本地抓取并转换 HTML,保留代码块(含语言提示)、表格和阅读结构,具备 SSRF 防护,不调用外部 API、不收集遥测数据。支持 Claude Desktop、Cursor、Windsurf、Zed 等 MCP 客户端,无需 API 密钥或账号。

访问官网

工具介绍

用途

page2ai-mcp 是一个 MCP(Model Context Protocol)服务器,用于把任意网页 URL 转换为干净的 Markdown,供 LLM 作为上下文使用。它从传入的 URL 抓取 HTML,在本地完成转换,并带有 SSRF 防护。整个过程不依赖外部 API,不发送遥测数据,唯一的网络请求就是访问你传入的 URL。

主要能力

  • 抓取、提取、转换:一个工具、一条命令,全部在本机完成。
  • 保留代码块(含语言提示)、表格和阅读结构;丢弃导航和页面装饰元素。
  • 输出包含 YAML front matter(标题、来源、抓取时间戳、提取器来源信息),随后是干净的 Markdown 正文。
  • 无需 API 密钥、无需账号、无遥测。
  • 自 0.2.0 起,同一 stdio 连接可同时应答两个 MCP 协议修订版本;serveStdio 根据首条消息判断协议时代,并为连接生命周期固定一个服务器实例,因此使用较旧 SDK 的客户端不受影响。
  • 自 0.2.5 起,非作用域包 page2ai-mcp 通过 ^ 范围自动跟随最新服务器版本。

使用方式

需要 Node.js 20+。启动的是 stdio MCP 服务器,它会静默等待客户端,因此应将其接入下列客户端之一,而不是单独运行。

  • 一键安装包:从最新 release 下载 page2ai-mcp-<version>.mcpb,然后在 Claude Desktop 中打开 Settings → Extensions → Advanced settings → Install Extension…,选择该文件。
  • Claude Desktop:添加到 claude_desktop_config.json(macOS:~/Library/Application Support/Claude/,Windows:%APPDATA%\Claude\),然后完全退出并重启 Claude Desktop。
  • Cursor:添加到 ~/.cursor/mcp.json(全局)或 .cursor/mcp.json(项目)。
  • VS Code(GitHub Copilot):添加到 .vscode/mcp.json。
  • Windsurf:添加到 ~/.codeium/windsurf/mcp_config.json(macOS/Linux)或 %USERPROFILE%.codeium\windsurf\mcp_config.json(Windows)。
  • Zed:添加到 settings.json(zed: open settings file)。
  • 其他 MCP 客户端:任何支持 stdio 的 MCP 客户端均可,例如 Cline、Continue、JetBrains AI Assistant、LM Studio 等,将其 MCP 服务器设置指向同一命令:npx -y page2ai-mcp。
  • 若 npx 提供了过期的缓存版本,可运行一次 npx -y page2ai-mcp@latest。
  • 让 AI 代理安装:可指向 llms-install.md,其中包含各客户端的精确命令和验证步骤。

托管端点(beta,无需安装):面向只接受远程 MCP 服务器 URL(Streamable HTTP)的客户端,提供同一工具、同一代码(见 remote/),按 IP 限流。隐私权衡:发送到托管端点的 URL 由该服务器抓取,会经过作者运营的基础设施(部署在 Vercel)。本地通过 npx 运行可让一切留在你的机器上,条件允许时优先选择本地运行。

工具参数:page_to_markdown 无需设置,每个参数都有合理默认值。计划中:profile 参数(auto | docs | marketing | research | dashboard | wordpress-marketing)。

示例提示词:

  1. 抓取文档并回答问题:“Use page_to_markdown to fetch https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking and summarize the three main use cases for extended thinking.”
  2. 提取 API 参考并生成代码片段:“Fetch https://ai.google.dev/gemini-api/docs/thinking with page_to_markdown, then generate a Python code sample using the thinking budget parameter.”
  3. 比较两个文档页面:“Fetch both https://docs.anthropic.com/en/docs/prompt-engineering and https://platform.openai.com/docs/guides/prompt-engineering with page_to_markdown, then summarize the differences in approach.”

适用场景

  • 为 Claude Desktop、Cursor、Windsurf、Zed 等 MCP 客户端提供网页内容作为 LLM 上下文。
  • 抓取文档并回答问题、提取 API 参考生成代码示例、比较两个文档页面。
  • 需要保留代码块、表格和阅读结构的网页内容提取。

限制与隐私

  • 需要 Node.js 20+。
  • 服务器本身不收集数据、不发送遥测,除你明确提供的 URL 外不进行外部网络调用。但你的 AI 客户端(Claude、ChatGPT 等)仍会按该客户端的隐私政策将提取出的 Markdown 发送给其模型提供商,这部分不在本服务器控制范围内,详见 PRIVACY.md。
  • 可选的托管端点性质不同:你要求转换的 URL 由作者运营的服务器(部署在 Vercel)抓取,Vercel 保留其标准运营日志;无账号、无跟踪。若该权衡对你的用例重要,请在本地运行服务器(代码相同)。
  • 已知安全公告:无。迁移到 v2 SDK 移除了 90 个传递依赖(生产依赖从 117 个降至 26 个),也移除了 0.1.x 通过单体 @modelcontextprotocol/sdk 携带的 @hono/node-server 公告;截至 0.2.0,npm audit 干净。
  • 构建来源:自 v0.1.2 起的发布通过 GitHub Actions 以 npm provenance 发布,每个版本带有 Sigstore 证明,记录在公开的 Rekor 透明账本中,并在 npmjs.com 上显示徽章。
  • 许可证:MIT,版权所有 © 2026 Igor Saevets。

相关项目

  • Page2AI Chrome 扩展:https://github.com/igorsaevets/page2ai-extension(同一提取核心,以浏览器扩展形式面向人类用户)
  • @page2ai/core:https://npmjs.com/package/@page2ai/core(共享提取库)
  • page2ai-mcp(非作用域):https://npmjs.com/package/page2ai-mcp(本包的薄封装,发布以便 npx -y page2ai-mcp 无需作用域前缀即可运行)
  • Software Heritage 存档:SWHID swh:1:snp:05123c51ef9e7c0aeb06f42b1263c07a8d26999a

作者:Igor Saevets,AI 专家、Page2AI 创始人。完整简介:igorsaevets.github.io/page2ai-docs/about/。