obscura-mcp

스크래핑 및 AI 에이전트 자동화를 위한 경량 Rust 헤드리스 브라우저인 Obscura용 MCP 서버 어댑터입니다.

Obscura의 네이티브 CDP 기능을 깔끔한 MCP 인터페이스를 통해 제공합니다. Chrome 의존성이나 무거운 브라우저 자동화 도구가 필요하지 않습니다.

설치

npm install -g obscura-mcp

설치는 즉시 완료됩니다. 브라우저 바이너리(~80 MB)는 처음 사용할 때 지연 다운로드됩니다.

설치 후 다음 중 하나를 수행하세요:

• obscura-mcp install을 실행하여 진행 상황을 확인하며 바이너리를 다운로드하거나,

• 그냥 obscura-mcp를 실행하세요. 자동으로 바이너리를 다운로드하고 서버를 시작합니다.

바이너리는 ~/.obscura/bin/에 캐시되며 npm 업그레이드 후에도 유지됩니다.

사용자 지정 바이너리 경로를 사용하려면:

export OBSCURA_PATH=/path/to/obscura

Related MCP server: Algonius Browser

빠른 시작

# Install
npm install -g obscura-mcp

# Verify
obscura-mcp --version

# Download browser binary
obscura-mcp install

# Start MCP server
obscura-mcp --transport stdio

도구

browse_url

Obscura의 CDP 엔진을 사용하여 URL을 가져옵니다. 페이지 콘텐츠를 반환합니다.

매개변수:

• url (문자열, 필수): 방문할 HTTP 또는 HTTPS URL.

• dump (문자열, 선택 사항): html, text 또는 links. 기본값은 html입니다.

• cookies (배열, 선택 사항): 탐색 전에 주입할 쿠키. browse_cookies가 반환하는 것과 동일한 형식을 허용합니다. 실제 브라우저에서 내보낸 쿠키를 전달하여 인증된 페이지에 액세스하세요.

• stealth (불리언, 선택 사항): 호환성을 위해 허용됩니다. 스텔스 동작은 Obscura 서버에 의해 제어됩니다.

browse_evaluate

URL로 이동하여 페이지 컨텍스트에서 JavaScript를 실행합니다. 평가된 결과를 반환합니다.

매개변수:

• url (문자열, 필수): 방문할 URL.

• expression (문자열, 필수): 평가할 JavaScript 표현식. 예: document.title, navigator.userAgent, document.querySelector('h1').textContent.

• stealth (불리언, 선택 사항): 호환성을 위해 허용됩니다.

browse_cookies

URL로 이동하여 페이지에 의해 설정된 모든 쿠키를 검색합니다. 각 쿠키의 이름, 값, 도메인, 경로 및 만료 시간을 반환합니다.

매개변수:

• url (문자열, 필수): 방문할 URL.

• stealth (불리언, 선택 사항): 호환성을 위해 허용됩니다.

구성

Claude Desktop / Cline / Continue / 모든 MCP 클라이언트

{
  "mcpServers": {
    "obscura-mcp": {
      "command": "obscura-mcp",
      "args": ["--transport", "stdio"]
    }
  }
}

VS Code (Cline 확장 프로그램)

{
  "servers": {
    "obscura-mcp": {
      "command": "obscura-mcp",
      "args": ["--transport", "stdio"]
    }
  }
}

전역 npm 설치 후 obscura-mcp는 PATH에 포함되므로 절대 경로가 필요하지 않습니다.

환경 변수

왜 Obscura인가?

• Chrome 없음 — 순수 Rust, 200MB 브라우저 번들 없음

• CDP 네이티브 — Chrome DevTools Protocol을 직접 노출

• 탐지 방지 — 스크래핑 방지 사이트를 위한 내장 스텔스 기능

• 작은 설치 공간 — ~15MB 바이너리, 밀리초 단위로 시작

라이선스

MIT