mcp-서버-요청

LLM이 웹 콘텐츠를 가져와 처리할 수 있도록 HTTP 요청 기능을 제공하는 MCP 서버입니다.

특징

웹 콘텐츠를 Markdown 형식으로 변환하는 기능을 지원합니다.
LLM에 쓸모없는 콘텐츠 필터링 지원
사용자 정의 User-Agent 헤더를 지원합니다.
임의의 User-Agent 헤더를 지원합니다.
HTTP 요청에서 사용자 정의 요청 헤더를 지원합니다.
전체 HTTP 메서드(GET, POST, PUT, DELETE, PATCH)를 지원합니다.
LLM은 전체 HTTP 응답 헤더 정보에 액세스할 수 있습니다.

Related MCP server: Fetch MCP Server

설치

지엑스피1

용법

MCP 서버 구성

{ "mcpServers": { "mcp-server-requests": { "command": "python", "args": [ "-m", "mcp_server_requests" ] } } }

명령줄

0. MCP 서버 시작

MCP 서버를 직접 시작합니다.

python -m mcp_server_requests

옵션

--user-agent TEXT : 사용자 정의 사용자 에이전트 문자열 지정
--random-user-agent [browser=xxx;os=xxx] : 무작위로 생성된 User-Agent를 사용합니다.
--force-user-agent : LLM에서 제공한 UA를 무시하고 명령줄에서 지정된 User-Agent를 사용하여 강제 실행합니다.
--list-os-and-browser : 임의의 사용자 에이전트 생성을 위해 사용 가능한 브라우저와 OS를 나열합니다.

옵션 세부 정보

--user-agent 와 --random-user-agent 상호 배타적이며 함께 사용할 수 없습니다.
사용자 에이전트 설정 방법:
- 사용자 정의 문자열: --user-agent "Mozilla/5.0 (...)"
- 완전 무작위: --random-user-agent
- 조건부 난수 생성:
  - 브라우저 유형을 지정하세요: --random-user-agent browser=chrome
  - OS 지정: --random-user-agent os=windows
  - 브라우저와 OS 모두: --random-user-agent browser=chrome;os=windows
  - 참고: 브라우저 및 OS 매개변수는 대소문자를 구분하지 않습니다.
--random-user-agent 에 사용할 수 있는 브라우저와 OS를 보려면 --list-os-and-browser 사용하세요.
--force-user-agent 사용자 에이전트 우선순위를 제어합니다.
- 활성화 시: --user-agent 또는 --random-user-agent 통해 명령줄에서 지정된 사용자 에이전트를 우선시하고 LLM에서 제공하는 UA는 무시합니다.
- 비활성화 시:
  - LLM이 User-Agent를 제공하는 경우 해당 항목을 사용하세요.
  - 그렇지 않으면 명령줄에 지정된 User-Agent를 사용합니다.

1. fetch - 웹 콘텐츠 가져오기

fetch 하위 명령은 fetch 도구 기능과 동일하며 fetch 기능을 보여줍니다.

python -m mcp_server_requests fetch <URL> [--return-content {raw,basic_clean,strict_clean,markdown}]

옵션:

--return-content : 콘텐츠 유형을 반환합니다(기본값: 마크다운)
- raw : 처리되지 않은 원시 HTML 콘텐츠를 반환합니다.
- basic_clean : 스크립트, 스타일과 같은 표시되지 않는 태그를 제거하는 기본 정리
- strict_clean : 비표시 태그와 대부분의 HTML 속성을 제거하는 엄격한 정리
- 마크다운 : HTML을 깔끔한 마크다운 형식으로 변환

예:

python -m mcp_server_requests fetch https://example.com

2. get - HTTP GET 요청 실행

get 하위 명령은 http_get 도구 기능과 동일하며 http_get 기능을 보여줍니다.

python -m mcp_server_requests get <URL> [--headers HEADERS]

옵션:

--headers : 사용자 정의 요청 헤더(형식: "key1=value1;key2=value2")

3. post - HTTP POST 요청 실행

post 하위 명령은 http_post 도구 기능과 동일하며 http_post 기능을 보여줍니다.

python -m mcp_server_requests post <URL> [--headers HEADERS] [--data TEXT]

옵션:

--headers : 사용자 정의 요청 헤더
--data : 요청 본문 데이터

4. put - HTTP PUT 요청 실행

put 하위 명령은 http_put 도구 기능과 동일하며 http_put 기능을 보여줍니다.

python -m mcp_server_requests put <URL> [--headers HEADERS] [--data TEXT]

옵션: POST 방식과 동일

5. delete - HTTP DELETE 요청 실행

delete 하위 명령은 http_delete 도구 기능과 동일하며 http_delete 기능을 보여줍니다.

python -m mcp_server_requests delete <URL> [--headers HEADERS] [--data TEXT]

옵션: POST 방식과 동일

기능성

사용 가능한 도구

fetch - 웹 콘텐츠 가져오기
- 매개변수:
  - url (필수): 대상 URL
  - return_content (선택 사항): 콘텐츠 유형('raw', 'basic_clean', 'strict_clean', 'markdown')을 반환합니다.
    - raw : 원시 HTML 콘텐츠를 반환합니다.
    - basic_clean : 스크립트, 스타일과 같은 표시되지 않는 태그를 제거하여 필터링된 HTML 콘텐츠를 반환합니다.
    - strict_clean : 필터링된 HTML 콘텐츠를 반환하고, 표시되지 않는 태그와 대부분의 쓸모없는 HTML 속성을 제거합니다.
    - markdown : HTML을 Markdown으로 변환하여 반환합니다.
http_get - HTTP GET 요청 실행
- 매개변수:
  - url (필수): 대상 URL
  - 쿼리 (선택 사항): 쿼리 매개변수 키-값 쌍
  - 헤더 (선택 사항): 사용자 정의 요청 헤더
    - LLM은 헤더에 User-Agent를 지정할 수 있으며, 이를 사용할지 여부는 --force-user-agent 로 제어됩니다(다른 도구에도 동일하게 적용됨).
http_post - HTTP POST 요청 실행
- 매개변수:
  - url (필수): 대상 URL
  - 쿼리 (선택 사항): 쿼리 매개변수 키-값 쌍
  - 헤더 (선택 사항): 사용자 정의 요청 헤더
  - data (선택 사항): 요청 본문 데이터(텍스트)
  - json (선택 사항): 요청 본문 데이터(JSON)
  - data 와 json은 함께 사용할 수 없습니다.
http_put - HTTP PUT 요청 실행
- 매개변수: http_post와 동일
http_patch - HTTP PATCH 요청 실행
- 매개변수: http_post와 동일
http_delete - HTTP DELETE 요청 실행
- 매개변수: http_post와 동일