HTTPX MCP Server

HTTPX MCP サーバー

📋 概要

HTTPX MCP サーバーは、Python の httpx ライブラリを使用して REST API 操作を実行する Model Context Protocol（MCP）の実装です。GET、POST、PUT、PATCH、DELETE など、HTTP リクエストを送信するためのさまざまなメソッドを提供します。

🚀 クイックスタート

uv を使用する場合：

git clone https://github.com/avishekjana-89/mcp-httpx.git
cd mcp-httpx
uv pip install .

Docker を使用する場合：

git clone https://github.com/avishekjana-89/mcp-httpx.git
cd mcp-httpx
docker build -t mcp/httpx .

🛠️ 利用可能なツール

このサーバーは、Web API とやり取りするための次の基本的なツールを提供します。

get_request

• 説明：指定した URL に対して GET リクエストを実行します。
• 引数：
  • url：スキーム、ホスト、パスを含む構造化 URL（例：https://example.com/path?query=value）。
  • token：認証用の任意のトークン。
  • headers：キーと値のペアで指定する任意の HTTP ヘッダー（例：{"Content-Type": "application/json"}）。
• 戻り値：URL、ステータスコード、レスポンス本文を含む辞書。

post_request

• 説明：指定した URL に、指定したペイロードを含む POST リクエストを実行します。
• 引数：
  • url：構造化 URL（例：https://example.com/path）。
  • data：リクエストとともに送信するペイロード（例：{"key": "value"}）。
  • token：認証用の任意のトークン。
  • headers：キーと値のペアで指定する任意の HTTP ヘッダー（例：{"Content-Type": "application/json"}）。
• 戻り値：URL、ステータスコード、レスポンス本文を含む辞書。

put_request

• 説明：指定した URL に、指定したペイロードを含む PUT リクエストを実行します。
• 引数：
  • url：構造化 URL（例：https://example.com/path）。
  • data：リクエストとともに送信するペイロード（例：{"key": "value"}）。
  • token：認証用の任意のトークン。
  • headers：キーと値のペアで指定する任意の HTTP ヘッダー。
• 戻り値：URL、ステータスコード、レスポンス本文を含む辞書。

patch_request

• 説明：指定した URL に、指定したペイロードを含む PATCH リクエストを実行します。
• 引数：
  • url：構造化 URL（例：https://example.com/path）。
  • data：リクエストとともに送信するペイロード（例：{"key": "value"}）。
  • token：認証用の任意のトークン。
  • headers：キーと値のペアで指定する任意の HTTP ヘッダー。
• 戻り値：URL、ステータスコード、レスポンス本文を含む辞書。

delete_request

• 説明：指定した URL に対して DELETE リクエストを実行します。
• 引数：
  • url：構造化 URL（例：https://example.com/path）。
  • token：認証用の任意のトークン。
  • headers：キーと値のペアで指定する任意の HTTP ヘッダー。
• 戻り値：URL、ステータスコード、レスポンス本文を含む辞書。

Claude Desktop での使用方法

uv を使用する場合

uv を使用して MCP サーバーを実行するには、次の設定を claude_desktop_config.json に追加します。

{
  "mcpServers":{
    "mcp-httpx":{
      "command":"uv",
      "args":[
        "--directory",
        "path_of_the_repo/mcp-httpx/src/mcp-httpx",
        "run",
        "server.py"
      ]
    }
  }
}

Docker を使用する場合

Docker 経由で MCP サーバーを実行するには、次の設定を claude_desktop_config.json に追加します。

{
  "mcpServers":{
    "mcp-httpx":{
      "command":"docker",
      "args":[
        "run",
        "-i",
        "--rm",
        "--name",
        "mcp-httpx",
        "mcp/httpx"
      ]
    }
  }
}

ライセンス

この MCP サーバーは MIT ライセンスの下で公開されています。MIT ライセンスの利用規約に従う限り、ソフトウェアを自由に使用、変更、配布できます。詳しくは、プロジェクトリポジトリ内の LICENSE ファイルを参照してください。