auth-fetch-mcp

MCP 服务器，允许 AI 助手从受身份验证保护的网页中获取内容。

当您的 AI 尝试读取需要登录的 URL 时，此工具会为您打开一个真实浏览器进行登录，然后将页面内容捕获为清理后的 HTML。会话会保存在本地，因此您每个服务只需登录一次。

演示

Related MCP server: byob

快速开始

Claude Code

claude mcp add --scope user auth-fetch -- npx auth-fetch-mcp@latest

.mcp.json (Cursor, Windsurf 等)

{
  "mcpServers": {
    "auth-fetch": {
      "command": "npx",
      "args": ["auth-fetch-mcp@latest"]
    }
  }
}

首次运行时，如果尚未安装 Chromium，系统会自动安装。

工作原理

1. 让您的 AI 读取任何需要身份验证的页面 — 只需粘贴 URL。

2. 浏览器窗口会自动打开并导航到该页面。

3. 像往常一样登录（支持 SSO、2FA、验证码等任何方式）。

4. 准备好后，点击右下角的 “📸 Capture” 按钮。

5. 页面内容将以清理后的 HTML 格式捕获（去除了噪音元素，保留了媒体标签），浏览器关闭，您的 AI 将收到该内容。

工具

auth_fetch

主要工具。使用真实浏览器获取页面内容，并在需要时打开窗口进行登录。返回清理后的 HTML，其中去除了噪音元素（导航、页脚、脚本等），并保留了媒体标签（<img>, <video>, <iframe>）。

download_media

使用保存的浏览器会话从 URL 下载文件。使用此工具可以延迟下载在 auth_fetch 结果中找到的图像、视频或其他文件。浏览器的已保存 Cookie 会自动处理身份验证 — 无需再次登录。

示例流程：

1. auth_fetch("https://notion.so/my-page")
   → Returns HTML with <img src="https://s3.notion.so/signed-url..."/> tags

2. AI reads the HTML, identifies an image it needs

3. download_media(["https://s3.notion.so/signed-url..."])
   → Downloads the image using saved session cookies
   → Returns { localPath: "~/.auth-fetch-mcp/downloads/.../file-1.png" }

list_pages

列出浏览器中所有打开的标签页及其 URL 和标题。

close_browser

关闭浏览器窗口。登录会话会被保存，并在下次使用时重复利用。

数据存储

所有数据均存储在本地 ~/.auth-fetch-mcp/ 下。没有任何数据发送到外部服务器。

要清除所有数据：

# Clear login sessions only
rm -rf ~/.auth-fetch-mcp/browser-data/

# Clear downloaded files only
rm -rf ~/.auth-fetch-mcp/downloads/

# Clear everything
rm -rf ~/.auth-fetch-mcp/

支持的 AI 工具

• Claude Code

• Cursor

• Windsurf

• 任何使用 stdio 传输的 MCP 兼容客户端

限制

• 需要本地环境（在基于 Web 的聊天界面中无法工作）

• 首次访问每个服务需要手动登录

• 超长页面会被截断以适应 LLM 上下文窗口（100K 字符）

• 某些具有强力机器人检测功能的网站可能无法工作（请尝试 wait_for 选项）

隐私

• 所有数据都保留在您的机器上 — 不会发送到外部服务器

• 捕获的 HTML 永远不会写入磁盘 — 它仅通过 stdio 管道传递给 AI 工具

• 浏览器会话作为标准 Chromium 配置文件存储在本地

• 下载的文件会进入您控制的本地目录

贡献

欢迎贡献！请提交 Issue 或 Pull Request。

git clone https://github.com/ymw0407/auth-fetch-mcp.git
cd auth-fetch-mcp
npm install
npm run build

许可证

MIT