mcp-server-requests
mcp-서버-요청
LLM이 웹 콘텐츠를 가져와 처리할 수 있도록 HTTP 요청 기능을 제공하는 MCP 서버입니다.
특징
웹 콘텐츠를 Markdown 형식으로 변환하는 기능을 지원합니다.
LLM에 쓸모없는 콘텐츠 필터링 지원
사용자 정의 User-Agent 헤더를 지원합니다.
임의의 User-Agent 헤더를 지원합니다.
HTTP 요청에서 사용자 정의 요청 헤더를 지원합니다.
전체 HTTP 메서드(GET, POST, PUT, DELETE, PATCH)를 지원합니다.
LLM은 전체 HTTP 응답 헤더 정보에 액세스할 수 있습니다.
Related MCP server: cURL 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=chromeOS 지정:
--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.com2. 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와 동일
특허
MIT
Available Tools
3 toolsfetchA
Fetch web page content
Function/Features:
Retrieves web page content from any HTTP/HTTPS URL
Args: url (str): The URL to fetch content from. return_content ('raw' | 'basic_clean' | 'strict_clean' | 'markdown', optional): Processing format for HTML content. Defaults to "markdown". - "raw": Returns unmodified HTML content with full response headers - "basic_clean": Removes non-displaying tags (script, style, meta, etc.) while preserving structure - "strict_clean": Removes non-displaying tags and most HTML attributes, keeping only essential structure - "markdown": Converts HTML content to clean, readable Markdown format
Examples: // Returns content as markdown fetch({url: "https://example.com"})
// Returns raw HTML content
fetch({url: "https://api.example.com/data", return_content: "raw"}) Inputs: url (required), return_content. Returns: result
fetch_to_fileA
Fetch web content and save it to a file in the workspace
Function/Features:
Retrieves web content from any HTTP/HTTPS URL and saves it to a file
Automatic directory creation for nested file paths
Notes:
Automatically creates parent directories if they don't exist
Uses UTF-8 encoding for all saved files
parameter
file_pathmust be a absolute path
Args: url (str): The URL to fetch content from. file_path (str): File path where the content will be saved. return_content ('raw' | 'basic_clean' | 'strict_clean' | 'markdown'], optional): Processing format for HTML content. Defaults to "markdown". - "raw": Saves unmodified HTML content - "basic_clean": Saves HTML with non-displaying tags removed (script, style, etc.) while preserving structure - "strict_clean": Saves HTML with non-displaying tags and most HTML attributes removed, keeping only essential structure - "markdown": Converts HTML content to clean, readable Markdown format before saving
Examples: // Save web page as markdown fetch_to_file({url: "https://example.com", file_path: "/home/user/content/example.md"})
// Save raw HTML content
fetch_to_file({url: "https://api.example.com/data", file_path: "C:\data\response.html", return_content: "raw"})
// Save cleaned content
fetch_to_file({url: "https://example.com/docs", file_path: "/tmp/docs/cleaned.html", return_content: "strict_clean"})Inputs: url (required), file_path (required), return_content. Returns: result
http_requestA
Execute an HTTP request with the specified method
Function/Features:
Sends HTTP requests using any standard method (GET, POST, PUT, PATCH, DELETE)
Allows custom HTTP headers
Returns complete HTTP response including status, headers, and body
Notes:
'data' and 'json' parameters are mutually exclusive - use only one
When using 'json', the Content-Type header is automatically set to 'application/json'
When using 'data', you may need to set appropriate Content-Type header manually
Query parameters are URL-encoded automatically and appended to the URL
The response includes the full HTTP response with status line, all headers, and body
Args: url (str): Target URL for the HTTP request. method ('GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'], optional): HTTP method to use. Defaults to "GET". query ({ [string]: string | number }, optional): Query parameters to append to the URL. Values are automatically converted to strings. Example: {'key1': 'value1', 'key2': 2}, becomes "key1=value1&key2=2" appended to the URL. headers ({ [string]: string }, optional): Custom HTTP request headers. data (str, optional): Text data to send in the request body. Cannot be used with 'json'. json (Any JSON, optional): Data to serialize as JSON and send in the request body. Cannot be used with 'data'.
Examples: // GET request (default method) http_request({url: "https://api.example.com/data"})
// GET request with query parameters
http_request({url: "https://api.example.com/search", query: {"q": "test", "limit": 10}})
// POST request with JSON data
http_request({url: "https://api.example.com/users", method: "POST", json: {"name": "John", "age": 30}})
// POST request with raw text data
http_request({url: "https://api.example.com/log", method: "POST", data: "This is a log message"})
// PUT request
http_request({url: "https://api.example.com/users/123", method: "PUT", json: {"name": "John Updated", "age": 31}})
// PATCH request
http_request({url: "https://api.example.com/users/123", method: "PATCH", json: {"age": 31, "email": "new@example.com"}})
// DELETE request
http_request({url: "https://api.example.com/users/123", method: "DELETE"})
// Request with custom headers
http_request({url: "https://api.example.com/secure", method: "POST", headers: {"Authorization": "Bearer token"}, json: {"key": "value"}})Inputs: url (required), method (required), query (required), headers (required), +2 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
The three tools have clearly distinct purposes with no overlap. 'fetch' retrieves web content for immediate use, 'fetch_to_file' saves web content to a file, and 'http_request' handles general HTTP requests with full control over methods and parameters. Each tool serves a unique function in the web request workflow.
All tools follow a consistent snake_case naming pattern with clear verb-action structure. 'fetch', 'fetch_to_file', and 'http_request' all use descriptive verbs that accurately reflect their functionality, maintaining excellent naming consistency throughout the toolset.
Three tools is reasonable for a web requests server, though slightly minimal. The tools cover the core use cases well, but the count feels slightly lean for a server that could potentially benefit from additional specialized tools like websocket handling or streaming responses.
The toolset provides comprehensive coverage for web request operations. It includes content fetching with processing options, file-based fetching, and a full-featured HTTP client supporting all major methods, headers, and data formats. No obvious gaps exist for a general-purpose web requests server.
Maintenance
Related MCP Connectors
Reliable web access for AI agents: smart HTTP, rotating proxies, and full-browser rendering.
Web tools for AI agents: URL to clean Markdown, site crawl, screenshots, PDF/Office to text, OCR.
Web data for agents: YouTube transcripts, screenshots, Google News, WHOIS, jobs, tech stack, more.
Web data for agents. Extract web pages, crawl websites, discover URLs, and search the web.
Related MCP Servers
- AlicenseCqualityFmaintenanceEnables LLMs to retrieve and process web content by fetching URLs and converting HTML to markdown, with support for chunked reading and customizable user-agents.1MIT
- AlicenseAqualityBmaintenanceEnables LLMs to make HTTP requests using structured cURL commands with support for multiple authentication methods, custom headers, and comprehensive request/response control.28 npm4MIT
- AlicenseNot gradedqualityCmaintenanceEnables LLMs to fetch and extract web content using browser automation, OCR, and multiple extraction methods, handling JavaScript rendering and anti-scraping techniques.17MIT
- AlicenseAqualityCmaintenanceEnables LLMs to make HTTP requests with OAuth2, session cookies, retry logic, and cURL command generation, while providing security features like SSRF protection and TLS enforcement.1MIT