Skip to main content
Glama
MCP-RQuest
by xxxbrian

mcp-rquest

PyPIバージョン Pythonのバージョン GitHubスター ライセンス

Claude やその他の LLM に高度な HTTP リクエスト機能を提供する Model Context Protocol (MCP) サーバーです。rquest をベースに構築されたこのサーバーは、正確な TLS/JA3/JA4 フィンガープリントを使用したリアルなブラウザエミュレーションを可能にし、モデルがウェブサイトとより自然にインタラクトし、一般的なボット対策を回避できるようにします。また、LLM による処理を容易にするために、PDF および HTML ドキュメントを Markdown 形式に変換することもできます。

特徴

  • 完全な HTTP メソッド: GET、POST、PUT、DELETE、PATCH、HEAD、OPTIONS、TRACE をサポート

  • ブラウザフィンガープリンティング:正確なTLS、JA3/JA4、HTTP/2ブラウザフィンガープリント

  • コンテンツ処理:

    • トークンカウントによる大規模なレスポンスの自動処理

    • LLM処理を向上させるためのHTMLからMarkdownへの変換

    • マーカーライブラリを使用したPDFからMarkdownへの変換

    • システムの一時ディレクトリに応答を安全に保存する

  • 認証サポート: 基本認証、ベアラー認証、カスタム認証方式

  • カスタマイズのリクエスト:

    • ヘッダー、Cookie、リダイレクト

    • フォームデータ、JSONペイロード、multipart/form-data

    • クエリパラメータ

  • SSLセキュリティ: BoringSSLを使用し、リアルなブラウザフィンガープリントで安全な接続を実現します。

Related MCP server: URL Fetch MCP

利用可能なツール

  • 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 - LLM 処理を改善するために HTML または PDF レスポンスを Markdown 形式に変換します

    • get_model_state - PDF モデルの読み込みプロセスの現在の状態を取得します

    • restart_model_loading - PDF モデルの読み込みプロセスが失敗または停止した場合に、それを再開します。

PDFサポート

mcp-rquest は PDF から Markdown への変換をサポートするようになりました。これにより、PDF ファイルをダウンロードして、LLM が処理しやすい Markdown 形式に変換できるようになりました。

  1. 自動PDF検出: PDFファイルはコンテンツの種類に基づいて自動的に検出されます

  2. シームレスな変換: 同じget_stored_response_with_markdownツールが HTML ファイルと PDF ファイルの両方で機能します

  3. 高品質な変換:マーカーライブラリを使用して、PDF から Markdown への正確な変換を実現します。

  4. 最適化されたパフォーマンス: リクエスト処理中の遅延を回避するために、パッケージのインストール中にモデルが事前にダウンロードされます。

インストール

uvの使用(推奨)

uvを使用する場合、特別なインストールは必要ありません。uvx 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の使用:

{
  "mcpServers": {
    "http-rquest": {
      "command": "pipx",
      "args": ["run", "mcp-rquest"]
    }
  }
}

ブラウザエミュレーション

mcp-rquestは、rquestの強力なブラウザエミュレーション機能を活用して、リアルなブラウザフィンガープリントを提供します。これにより、ボット検出を回避し、通常は標準ブラウザでのみ利用可能なコンテンツにアクセスできます。サポートされているブラウザフィンガープリントは次のとおりです。

  • Chrome(複数のバージョン)

  • ファイアフォックス

  • Safari(iOS版およびiPad版を含む)

  • 角

  • OKHttp

これにより、mcp-rquest を介して送信されたリクエストがボット リクエストではなく正当なブラウザ トラフィックとして表示されるようになります。

発達

開発環境の構築

  1. リポジトリをクローンする

  2. uv を使用して仮想環境を作成します。

    uv venv
  3. 仮想環境をアクティブ化します。

    # Unix/macOS
    source .venv/bin/activate
    # Windows
    .venv\Scripts\activate
  4. 開発依存関係をインストールします。

    uv pip install -e ".[dev]"

謝辞

  • このプロジェクトは、ブラウザ フィンガープリント機能を備えた高度な HTTP クライアントを提供するrquest上に構築されています。

  • rquest はreqwestのフォークに基づいています。

Available Tools

12 tools
get_model_stateB

Get the current state of the PDF models(used by get_stored_response_with_markdown) loading process

Inputs: no named parameters.

get_stored_responseC

Retrieve a stored HTTP response by its ID

Inputs: response_id (required), end_line, start_line.

get_stored_response_with_markdownA

Retrieve a stored HTTP response by its ID and convert it to Markdown format. Supports HTML and PDF content types. (Converting large PDF to Markdown may cause timeout, just wait and try again.)

Inputs: response_id (required).

http_deleteC

Make an HTTP DELETE request to the specified URL

Inputs: url (required), auth, proxy, query, +7 more.

http_getC

Make an HTTP GET request to the specified URL

Inputs: url (required), auth, proxy, query, +7 more.

http_headC

Make an HTTP HEAD request to retrieve only headers from the specified URL

Inputs: url (required), auth, proxy, query, +7 more.

http_optionsC

Make an HTTP OPTIONS request to retrieve options for the specified URL

Inputs: url (required), auth, proxy, query, +7 more.

http_patchA

Make an HTTP PATCH request to the specified URL

Inputs: url (required), auth, body, form, +11 more.

http_postC

Make an HTTP POST request to the specified URL

Inputs: url (required), auth, body, form, +11 more.

http_putC

Make an HTTP PUT request to the specified URL

Inputs: url (required), auth, body, form, +11 more.

http_traceA

Make an HTTP TRACE request for diagnostic tracing of the specified URL

Inputs: url (required), auth, proxy, query, +7 more.

restart_model_loadingA

Restart the PDF models(used by get_stored_response_with_markdown) loading process if it failed or got stuck

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 12 tools

    Disambiguation4/5

    The HTTP method tools are clearly distinct, and the two stored response tools are differentiated by markdown conversion. However, get_stored_response and get_stored_response_with_markdown could be confused by an agent without careful reading, but descriptions mitigate ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent snake_case verb_noun pattern, with http_ prefix for HTTP methods and clear action words like get, restart, and retrieve. The naming is highly predictable and uniform.

    Tool Count5/5

    12 tools is well-scoped for an HTTP client with model management and stored response retrieval. Each tool has a clear purpose, and the count is neither sparse nor overwhelming.

    Completeness4/5

    The HTTP methods cover all standard request types, and stored response handling is present. Minor gaps include no tool to clear or list stored responses, and model state tools are limited to get and restart, but core functionality is complete.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that provides browser automation capabilities using BrowserCat's cloud browser service. This server enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment without needing to install browsers locally.
      7
      6
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that enables Claude or other LLMs to fetch content from URLs, supporting HTML, JSON, text, and images with configurable request parameters.
      3
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that provides enhanced browser automation capabilities using Puppeteer-Extra with Stealth Plugin, enabling LLMs to interact with web pages in a way that better emulates human behavior and avoids detection as automation.
      3
      MIT