项目介绍
mcp-rquest
这是一个提供高级HTTP请求功能的Model Context Protocol (MCP)服务器，适用于Claude和其他大型语言模型（LLMs）。基于rquest，此服务器能够实现逼真的浏览器模拟，具有准确的TLS/JA3/JA4指纹，使模型能够更自然地与网站互动，并绕过常见的反机器人措施。它还支持将PDF和HTML文档转换为Markdown，以便于LLMs处理。
功能
- 完整的HTTP方法：支持GET、POST、PUT、DELETE、PATCH、HEAD、OPTIONS和TRACE
- 浏览器指纹识别：准确的TLS、JA3/JA4和HTTP/2浏览器指纹
- 内容处理：
- 自动处理大型响应并进行令牌计数
- 将HTML转换为Markdown以更好地处理LLMs
- 使用Marker库将PDF转换为Markdown
- 在系统临时目录中安全存储响应
- 身份验证支持：基本、Bearer和自定义身份验证方法
- 请求定制：
- 头部、cookie、重定向
- 表单数据、JSON负载、multipart/form-data
- 查询参数
- SSL安全性：使用BoringSSL实现安全连接，并具有逼真的浏览器指纹
可用工具
-
HTTP请求工具：
http_get- 执行带有可选参数的GET请求http_post- 通过POST请求提交数据http_put- 使用PUT请求更新资源http_delete- 使用DELETE请求删除资源http_patch- 部分更新资源http_head- 仅从资源中检索头部信息http_options- 检索资源的选项http_trace- 诊断请求跟踪
-
响应处理工具：
get_stored_response- 检索存储的大型响应，可选按行范围检索get_stored_response_with_markdown- 将HTML或PDF响应转换为Markdown格式，便于LLMs处理get_model_state- 获取PDF模型加载过程的当前状态restart_model_loading- 如果加载失败或卡住，重新启动PDF模型加载过程
PDF支持
mcp-rquest现在支持PDF到Markdown的转换，允许您下载PDF文件并将其转换为易于LLMs处理的Markdown格式：
- 自动PDF检测：根据内容类型自动检测PDF文件
- 无缝转换：相同的
get_stored_response_with_markdown工具可用于HTML和PDF文件 - 高质量转换：使用Marker库进行准确的PDF到Markdown转换
- 优化性能：在安装包时预下载模型，避免请求处理期间的延迟
安装
使用uv（推荐）
当使用uv时不需要特定的安装步骤。我们将使用uvx直接运行_mcp-rquest_。
使用pip
或者，您可以通过pip安装mcp-rquest：
pip install mcp-rquest
安装后，可以使用以下命令作为脚本运行：
python -m mcp_rquest
配置
针对Claude.app配置
添加到您的Claude设置中：
使用uvx：
{
"mcpServers": {
"http-rquest": {
"command": "uvx",
"args": ["mcp-rquest"]
}
}
}
使用pip：
{
"mcpServers": {
"http-rquest": {
"command": "python",
"args": ["-m", "mcp_rquest"]
}
}
}
使用pipx：
{
8 "mcpServers": {
"http-rquest": {
"command": "pipx",
"args": ["run", "mcp-rquest"]
}
}
}
浏览器模拟
mcp-rquest利用rquest的强大浏览器模拟能力，提供逼真的浏览器指纹，有助于绕过机器人检测并访问通常只对标准浏览器开放的内容。支持的浏览器指纹包括：
- Chrome（多个版本）
- Firefox
- Safari（包括iOS和iPad版本）
- Edge
- OkHttp
这确保了通过mcp-rquest发送的请求看起来像是合法的浏览器流量，而不是机器人请求。
开发
设置开发环境
- 克隆仓库
- 使用uv创建虚拟环境：
uv venv - 激活虚拟环境：
# Unix/macOS source .venv/bin/activate # Windows .venv\Scripts\activate - 安装开发依赖项：
uv pip install -e ".[dev]"