HTTPX MCP Server

HTTPX MCP 服务

📋 概述

HTTPX MCP 服务是模型上下文协议（MCP）的一种实现，使用 Python httpx 库执行 REST API 操作。它提供多种 HTTP 请求方法，包括 GET、POST、PUT、PATCH 和 DELETE。

🚀 快速开始

使用 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：包含 scheme、host 和 path 的结构化 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 文件。