mcp-rquest

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のフォークに基づいています。