auth-fetch-mcp

AI 어시스턴트가 인증된 웹 페이지에서 콘텐츠를 가져올 수 있게 해주는 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 결과에서 발견된 이미지, 비디오 또는 기타 파일을 지연 다운로드할 때 사용하세요. 브라우저에 저장된 쿠키가 자동으로 인증을 처리하므로 다시 로그인할 필요가 없습니다.

예시 흐름:

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 호환 클라이언트

제한 사항

• 로컬 환경이 필요합니다 (웹 기반 채팅 인터페이스에서는 작동하지 않음)

• 각 서비스에 처음 접근할 때는 수동 로그인이 필요합니다

• 매우 긴 페이지는 LLM 컨텍스트 윈도우(100K 문자)에 맞게 잘립니다

• 강력한 봇 탐지 기능이 있는 일부 사이트는 작동하지 않을 수 있습니다 (wait_for 옵션을 시도해 보세요)

개인정보 보호

• 모든 데이터는 사용자의 컴퓨터에 머무르며 외부 서버로 전송되지 않습니다

• 캡처된 HTML은 디스크에 기록되지 않으며 stdio 파이프를 통해 AI 도구로만 전달됩니다

• 브라우저 세션은 표준 Chromium 프로필로 로컬에 저장됩니다

• 다운로드된 파일은 사용자가 제어하는 로컬 디렉토리로 이동합니다

기여

기여를 환영합니다! 이슈를 열거나 풀 리퀘스트를 제출해 주세요.

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

라이선스

MIT