auth-fetch-mcp

AIアシスタントが認証済みWebページからコンテンツを取得できるようにするMCPサーバーです。

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、CAPTCHAなど、すべてサポートされています）。

4. 準備ができたら、右下の 「📸 Capture」 ボタンをクリックします。

5. ページコンテンツがクリーンなHTMLとしてキャプチャされ（ノイズ要素が削除され、メディアタグが保持されます）、ブラウザが閉じ、AIがコンテンツを受け取ります。

ツール

auth_fetch

主要なツールです。実際のブラウザを使用してページコンテンツを取得し、必要に応じてログイン用のウィンドウを開きます。ノイズ要素（ナビゲーション、フッター、スクリプトなど）が削除され、メディアタグ（<img>, <video>, <iframe>）が保持されたクリーンなHTMLを返します。

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のコンテキストウィンドウ（10万文字）に収まるように切り詰められます

• 強力なボット検出を行う一部のサイトでは動作しない場合があります（wait_forオプションを試してください）

プライバシー

• すべてのデータはマシン内に留まり、外部サーバーには何も送信されません

• キャプチャされたHTMLはディスクに書き込まれることはなく、stdioパイプを通ってAIツールに渡されるだけです

• ブラウザセッションは標準のChromiumプロファイルとしてローカルに保存されます

• ダウンロードされたファイルは、ユーザーが管理するローカルディレクトリに保存されます

コントリビューション

コントリビューションを歓迎します！Issueを開くか、プルリクエストを送信してください。

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

ライセンス

MIT