# mcp-rquest
[](https://pypi.org/project/mcp-rquest/) [](https://pypi.org/project/mcp-rquest/) [](https://github.com/xxxbrian/mcp-rquest) [](https://github.com/xxxbrian/mcp-rquest)
A Model Context Protocol (MCP) server that provides advanced HTTP request capabilities for Claude and other LLMs. Built on [rquest](https://github.com/0x676e67/rquest), this server enables realistic browser emulation with accurate TLS/JA3/JA4 fingerprints, allowing models to interact with websites more naturally and bypass common anti-bot measures.
## Features
- **Complete HTTP Methods**: Support for GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS, and TRACE
- **Browser Fingerprinting**: Accurate TLS, JA3/JA4, and HTTP/2 browser fingerprints
- **Content Handling**:
- Automatic handling of large responses with token counting
- HTML to Markdown conversion for better LLM processing
- Secure storage of responses in system temporary directories
- **Authentication Support**: Basic, Bearer, and custom authentication methods
- **Request Customization**:
- Headers, cookies, redirects
- Form data, JSON payloads, multipart/form-data
- Query parameters
- **SSL Security**: Uses BoringSSL for secure connections with realistic browser fingerprints
## Available Tools
- **HTTP Request Tools**:
- `http_get` - Perform GET requests with optional parameters
- `http_post` - Submit data via POST requests
- `http_put` - Update resources with PUT requests
- `http_delete` - Remove resources with DELETE requests
- `http_patch` - Partially update resources
- `http_head` - Retrieve only headers from a resource
- `http_options` - Retrieve options for a resource
- `http_trace` - Diagnostic request tracing
- **Response Handling Tools**:
- `get_stored_response` - Retrieve stored large responses, optionally by line range
- `get_stored_response_with_markdown` - Convert HTML responses to Markdown
## Installation
### Using uv (recommended)
When using [`uv`](https://docs.astral.sh/uv/) no specific installation is needed. We will
use [`uvx`](https://docs.astral.sh/uv/guides/tools/) to directly run _mcp-rquest_.
### Using pip
Alternatively you can install `mcp-rquest` via pip:
```bash
pip install mcp-rquest
```
After installation, you can run it as a script using:
```bash
python -m mcp_rquest
```
## Configuration
### Configure for Claude.app
Add to your Claude settings:
Using `uvx`:
```json
{
"mcpServers": {
"http-rquest": {
"command": "uvx",
"args": ["mcp-rquest"]
}
}
}
```
Using `pip`:
```json
{
"mcpServers": {
"http-rquest": {
"command": "python",
"args": ["-m", "mcp_rquest"]
}
}
}
```
Using `pipx`:
```json
{
"mcpServers": {
"http-rquest": {
"command": "pipx",
"args": ["run", "mcp-rquest"]
}
}
}
```
</details>
## Browser Emulation
mcp-rquest leverages rquest's powerful browser emulation capabilities to provide realistic browser fingerprints, which helps bypass bot detection and access content normally available only to standard browsers. Supported browser fingerprints include:
- Chrome (multiple versions)
- Firefox
- Safari (including iOS and iPad versions)
- Edge
- OkHttp
This ensures that requests sent through mcp-rquest appear as legitimate browser traffic rather than bot requests.
## Development
### Setting up a Development Environment
1. Clone the repository
2. Create a virtual environment using uv:
```bash
uv venv
```
3. Activate the virtual environment:
```bash
# Unix/macOS
source .venv/bin/activate
# Windows
.venv\Scripts\activate
```
4. Install development dependencies:
```bash
uv pip install -e ".[dev]"
```
## Acknowledgements
- This project is built on top of [rquest](https://github.com/0x676e67/rquest), which provides the advanced HTTP client with browser fingerprinting capabilities.
- rquest is based on a fork of [reqwest](https://github.com/seanmonstar/reqwest).
Raw data
{
"_id": null,
"home_page": null,
"name": "mcp-rquest",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "anti-bot, api, browser-emulation, claude, http, ja3, ja4, llm, mcp, request, tls-fingerprint",
"author": null,
"author_email": "Bojin Li <hi@bojin.li>",
"download_url": "https://files.pythonhosted.org/packages/f7/d2/9e67d2acd238ecdd81e90a653deb20b013405a2e26c0e083acbabea1a159/mcp_rquest-0.1.7.tar.gz",
"platform": null,
"description": "# mcp-rquest\n\n[](https://pypi.org/project/mcp-rquest/) [](https://pypi.org/project/mcp-rquest/) [](https://github.com/xxxbrian/mcp-rquest) [](https://github.com/xxxbrian/mcp-rquest)\n\nA Model Context Protocol (MCP) server that provides advanced HTTP request capabilities for Claude and other LLMs. Built on [rquest](https://github.com/0x676e67/rquest), this server enables realistic browser emulation with accurate TLS/JA3/JA4 fingerprints, allowing models to interact with websites more naturally and bypass common anti-bot measures.\n\n## Features\n\n- **Complete HTTP Methods**: Support for GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS, and TRACE\n- **Browser Fingerprinting**: Accurate TLS, JA3/JA4, and HTTP/2 browser fingerprints\n- **Content Handling**:\n - Automatic handling of large responses with token counting\n - HTML to Markdown conversion for better LLM processing\n - Secure storage of responses in system temporary directories\n- **Authentication Support**: Basic, Bearer, and custom authentication methods\n- **Request Customization**:\n - Headers, cookies, redirects\n - Form data, JSON payloads, multipart/form-data\n - Query parameters\n- **SSL Security**: Uses BoringSSL for secure connections with realistic browser fingerprints\n\n## Available Tools\n\n- **HTTP Request Tools**:\n\n - `http_get` - Perform GET requests with optional parameters\n - `http_post` - Submit data via POST requests\n - `http_put` - Update resources with PUT requests\n - `http_delete` - Remove resources with DELETE requests\n - `http_patch` - Partially update resources\n - `http_head` - Retrieve only headers from a resource\n - `http_options` - Retrieve options for a resource\n - `http_trace` - Diagnostic request tracing\n\n- **Response Handling Tools**:\n - `get_stored_response` - Retrieve stored large responses, optionally by line range\n - `get_stored_response_with_markdown` - Convert HTML responses to Markdown\n\n## Installation\n\n### Using uv (recommended)\n\nWhen using [`uv`](https://docs.astral.sh/uv/) no specific installation is needed. We will\nuse [`uvx`](https://docs.astral.sh/uv/guides/tools/) to directly run _mcp-rquest_.\n\n### Using pip\n\nAlternatively you can install `mcp-rquest` via pip:\n\n```bash\npip install mcp-rquest\n```\n\nAfter installation, you can run it as a script using:\n\n```bash\npython -m mcp_rquest\n```\n\n## Configuration\n\n### Configure for Claude.app\n\nAdd to your Claude settings:\n\nUsing `uvx`:\n\n```json\n{\n \"mcpServers\": {\n \"http-rquest\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-rquest\"]\n }\n }\n}\n```\n\nUsing `pip`:\n\n```json\n{\n \"mcpServers\": {\n \"http-rquest\": {\n \"command\": \"python\",\n \"args\": [\"-m\", \"mcp_rquest\"]\n }\n }\n}\n```\n\nUsing `pipx`:\n\n```json\n{\n \"mcpServers\": {\n \"http-rquest\": {\n \"command\": \"pipx\",\n \"args\": [\"run\", \"mcp-rquest\"]\n }\n }\n}\n```\n\n</details>\n\n## Browser Emulation\n\nmcp-rquest leverages rquest's powerful browser emulation capabilities to provide realistic browser fingerprints, which helps bypass bot detection and access content normally available only to standard browsers. Supported browser fingerprints include:\n\n- Chrome (multiple versions)\n- Firefox\n- Safari (including iOS and iPad versions)\n- Edge\n- OkHttp\n\nThis ensures that requests sent through mcp-rquest appear as legitimate browser traffic rather than bot requests.\n\n## Development\n\n### Setting up a Development Environment\n\n1. Clone the repository\n2. Create a virtual environment using uv:\n ```bash\n uv venv\n ```\n3. Activate the virtual environment:\n ```bash\n # Unix/macOS\n source .venv/bin/activate\n # Windows\n .venv\\Scripts\\activate\n ```\n4. Install development dependencies:\n ```bash\n uv pip install -e \".[dev]\"\n ```\n\n## Acknowledgements\n\n- This project is built on top of [rquest](https://github.com/0x676e67/rquest), which provides the advanced HTTP client with browser fingerprinting capabilities.\n- rquest is based on a fork of [reqwest](https://github.com/seanmonstar/reqwest).\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Model Context Protocol (MCP) server providing advanced HTTP request capabilities with realistic browser emulation for Claude and other LLMs",
"version": "0.1.7",
"project_urls": {
"Bug Tracker": "https://github.com/xxxbrian/mcp-rquest/issues",
"Homepage": "https://github.com/xxxbrian/mcp-rquest"
},
"split_keywords": [
"anti-bot",
" api",
" browser-emulation",
" claude",
" http",
" ja3",
" ja4",
" llm",
" mcp",
" request",
" tls-fingerprint"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "bb014ce0d3a8c48b424bb81f894bc5a8d646ff43d4b2d6962ce57f384fe98870",
"md5": "1bb8afd2d7e16fd24286db7323a532d8",
"sha256": "b537f30f4164afa39e6c58a47bfc55a39644bc70f63f0f255ed1d0123cbc6998"
},
"downloads": -1,
"filename": "mcp_rquest-0.1.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1bb8afd2d7e16fd24286db7323a532d8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 9098,
"upload_time": "2025-03-19T12:42:49",
"upload_time_iso_8601": "2025-03-19T12:42:49.598162Z",
"url": "https://files.pythonhosted.org/packages/bb/01/4ce0d3a8c48b424bb81f894bc5a8d646ff43d4b2d6962ce57f384fe98870/mcp_rquest-0.1.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "f7d29e67d2acd238ecdd81e90a653deb20b013405a2e26c0e083acbabea1a159",
"md5": "12f102bf519bae4112423ddb2244288f",
"sha256": "8b666b1cc27a481f5d5f4131a7d649f56f0b2f685ecc9d994d5f824e01db4f58"
},
"downloads": -1,
"filename": "mcp_rquest-0.1.7.tar.gz",
"has_sig": false,
"md5_digest": "12f102bf519bae4112423ddb2244288f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 63152,
"upload_time": "2025-03-19T12:42:51",
"upload_time_iso_8601": "2025-03-19T12:42:51.217912Z",
"url": "https://files.pythonhosted.org/packages/f7/d2/9e67d2acd238ecdd81e90a653deb20b013405a2e26c0e083acbabea1a159/mcp_rquest-0.1.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-03-19 12:42:51",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "xxxbrian",
"github_project": "mcp-rquest",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "mcp-rquest"
}
JSON
