Mcp Http

MCP HTTP サーバー

📋 プロジェクト概要

MCP Http Server は、Python の httpx ライブラリをベースに実装された Model Context Protocol（MCP）サーバーです。REST API を介した HTTP リクエスト操作に対応しており、GET、POST、PUT、DELETE などのさまざまなメソッドを利用できます。さまざまな Web API との連携を簡素化することを目的としています。

🚀 クイックスタート

依存関係

• Python 3.x
• httpx ライブラリ
• uv（推奨パッケージマネージャー）

インストールと起動

プロジェクトをクローンする

git clone https://github.com/one-matrix/mcp-http.git
cd mcp-http

one-matrix は、実際のユーザー名またはプロジェクトの URL に置き換えてください。

依存関係をインストールする

uv を使用する場合（推奨）：

uv pip install .

または、pip を使用する場合：

pip install .

サーバーを起動する

プロジェクトに実際の起動コマンドを追加してください。例：python server.py または uv run server.py。

🛠️ 利用可能なツール

このサービスでは、Web API との連携に次のコアツールを利用できます。

1. http_get

• 説明： 指定された URL に GET リクエストを実行します。
• パラメーター：
  • url（str）：対象の URL。例：https://api.example.com/data。
  • params（dict、省略可）：URL クエリパラメーターの辞書。
• 戻り値： ステータスコード（int）とレスポンス本文（str）。

2. http_post

• 説明： 指定された URL に POST リクエストを実行します。必要に応じてデータ本文を指定できます。
• パラメーター：
  • url（str）：対象の URL。
  • params（dict、省略可）：URL クエリパラメーターの辞書。
  • body（dict、省略可）：JSON リクエスト本文の辞書。
  • headers（dict、省略可）：リクエストヘッダー。デフォルトでは Content-Type: application/json が含まれます。
• 戻り値： ステータスコード（int）とレスポンス本文（str）。

3. http_put

• 説明： 指定された URL に PUT リクエストを実行します。必要に応じてデータ本文を指定できます。
• パラメーター：
  • url（str）：対象の URL。
  • params（dict、省略可）：URL クエリパラメーターの辞書。
  • body（dict、省略可）：JSON リクエスト本文の辞書。
  • headers（dict、省略可）：リクエストヘッダー。デフォルトでは Content-Type: application/json が含まれます。
• 戻り値： ステータスコード（int）とレスポンス本文（str）。

4. http_delete

• 説明： 指定された URL に DELETE リクエストを実行します。
• パラメーター：
  • url（str）：対象の URL。
  • params（dict、省略可）：URL クエリパラメーターの辞書。
• 戻り値： ステータスコード（int）とレスポンス本文（str）。

元の文書ではこれを「ステータスコード文字列」と説明していましたが、通常、ステータスコードは整数であり、レスポンス本文は空または簡単な確認メッセージの場合があります。一貫性を保つため、このように修正しました。

🤝 Claude Desktop との連携

この MCP Http Server は Claude Desktop と連携できます。

方法 1：uv を使用して起動する

claude_desktop_config.json ファイルに次の設定を追加してください。

{
  "mcpServers": {
    "mcp-httpx": {
      "command": "uv",
      "args": [
        "--from",
        "git+https://github.com/one-matrix/mcp-http", 
        "run",
        "mcp-http"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-httpx": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/one-matrix/mcp-http", 
        "mcp-http" 
      ]
    }
  }
}

または、次のコマンドでインストールできます：uv pip install mcp-http

{
  "mcpServers": {
    "mcp-httpx": {
      "command": "uv",
      "args": [
        "run",
        "-m",
        "mcp_http"
      ]
    }
  }
}

例

📜 ライセンス

このプロジェクトは MIT ライセンスのもとでオープンソースとして公開されています。このソフトウェアは自由に使用、変更、配布できます。具体的な条件については、プロジェクトリポジトリ内の LICENSE ファイルを参照してください。