Rquest

Rquest는 정확한 TLS/JA3/JA4 지문을 갖춘 현실적인 브라우저와 같은 HTTP 요청 기능을 제공하는 MCP 서버입니다. 이 서버는 안티봇 조치를 우회하기 위한 고급 브라우저 핑거프린팅 기능을 통해 LLM이 보호된 웹사이트에 접근할 수 있도록 도와줍니다. 또한 HTML 및 PDF 문서를 Markdown으로 변환하여 LLM이 쉽게 처리할 수 있도록 지원합니다.

특징

• 정확한 브라우저 지문: TLS, JA3/JA4, HTTP/2 브라우저 지문을 정확하게 모방하여 안티봇 탐지 우회
• 전체 HTTP 메서드 지원: GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS, TRACE 등 모든 주요 HTTP 메서드 제공
• 문서 변환: HTML과 PDF 파일을 Markdown으로 자동 변환하여 LLM이 쉽게 처리할 수 있도록 지원
• 고급 요청 제어: 헤더, 쿠키, 프록시 등의 세부 설정 가능
• 효율적인 응답 처리: 응답 데이터를 효율적으로 처리하고 저장하는 메커니즘 제공

API

도구

HTTP 요청

• request: HTTP 요청 수행
• 입력: URL, 메서드, 헤더, 본문 데이터 등

• 출력: 상태 코드, 응답 헤더, 응답 본문

• get: GET 요청 수행을 위한 간편 메서드

• 입력: URL, 선택적 헤더

• 출력: 응답 데이터

• post: POST 요청 수행을 위한 간편 메서드

• 입력: URL, 데이터, 선택적 헤더
• 출력: 응답 데이터

문서 변환

• get_stored_response_with_markdown: HTML 또는 PDF 응답을 Markdown 형식으로 변환
• 입력: 응답 ID 또는 URL
• 출력: Markdown 형식의 문서 콘텐츠

모델 관리

• get_model_state: PDF 모델 로딩 프로세스의 현재 상태 조회
• 입력: 없음

• 출력: 모델 상태 정보

• restart_model_loading: PDF 모델 로딩 프로세스 재시작

• 입력: 없음
• 출력: 재시작 작업 성공 여부

사용 방법

설치

# uv 패키지 관리자 사용
uvx mcp-rquest

# 또는 npm 사용
npm install -g mcp-rquest

구성

Claude Desktop에서 이 서버를 사용하려면 다음과 같이 설정 파일에 추가할 수 있습니다:

{
  "mcpServers": {
    "rquest": {
      "command": "uvx",
      "args": ["mcp-rquest"]
    }
  }
}

사용 예시

// 기본 GET 요청
const response = await get("https://example.com");
console.log(response.body);

// 사용자 에이전트 헤더를 사용한 GET 요청
const headers = {
  "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36"
};
const response = await get("https://example.com", { headers });

// JSON 데이터로 POST 요청
const data = { username: "testuser", password: "password123" };
const response = await post("https://api.example.com/login", data);

// HTML을 Markdown으로 변환
const markdown = await get_stored_response_with_markdown(response.id);

연결된 구성 요소

• Fetch - 기본적인 웹 콘텐츠 가져오기 기능 제공
• browser-use - 브라우저 자동화를 통한 웹 스크래핑
• scrapling-fetch - 안티 자동화 조치가 있는 웹사이트에서 HTML/마크다운 가져오기