mcp-httpx
If you are the rightful owner of mcp-httpx and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
The HTTPX MCP Server is a REST API server using the Python `httpx` library, supporting various HTTP methods.
HTTPX MCP Server
📋 Overview
The HTTPX MCP Server is an implementation of the Model Context Protocol (MCP) that performs REST API operations using the Python httpx library. It provides various methods for making HTTP requests, including GET, POST, PUT, PATCH, and DELETE.
🚀 Quick Start
Using uv:
git clone https://github.com/avishekjana-89/mcp-httpx.git
cd mcp-httpx
uv pip install .
Using Docker:
git clone https://github.com/avishekjana-89/mcp-httpx.git
cd mcp-httpx
docker build -t mcp/httpx .
🛠️ Available Tools
The server provides the following core tools for interacting with web APIs:
get_request
- Description: Executes a
GETrequest for the specified URL. - Arguments:
url: A structured URL with scheme, host, and path (e.g.,https://example.com/path?query=value).token: Optional token for authentication.headers: Optional HTTP headers as key-value pairs (e.g.,{"Content-Type": "application/json"}).
- Returns: A dictionary containing the URL, status code, and the response body.
post_request
- Description: Executes a
POSTrequest for the specified URL with a given payload. - Arguments:
url: A structured URL (e.g.,https://example.com/path).data: The payload to send with the request (e.g.,{"key": "value"}).token: Optional token for authentication.headers: Optional HTTP headers as key-value pairs (e.g.,{"Content-Type": "application/json"}).
- Returns: A dictionary containing the URL, status code, and the response body.
put_request
- Description: Executes a
PUTrequest for the specified URL with a given payload. - Arguments:
url: A structured URL (e.g.,https://example.com/path).data: The payload to send with the request (e.g.,{"key": "value"}).token: Optional token for authentication.headers: Optional HTTP headers as key-value pairs.
- Returns: A dictionary containing the URL, status code, and the response body.
patch_request
- Description: Executes a
PATCHrequest for the specified URL with a given payload. - Arguments:
url: A structured URL (e.g.,https://example.com/path).data: The payload to send with the request (e.g.,{"key": "value"}).token: Optional token for authentication.headers: Optional HTTP headers as key-value pairs.
- Returns: A dictionary containing the URL, status code, and the response body.
delete_request
- Description: Executes a
DELETErequest for the specified URL. - Arguments:
url: A structured URL (e.g.,https://example.com/path).token: Optional token for authentication.headers: Optional HTTP headers as key-value pairs.
- Returns: A dictionary containing the URL, status code, and the response body.
Usage with Claude Desktop
Using uv
To run the MCP server using uv, add the following configuration to your claude_desktop_config.json:
{
"mcpServers":{
"mcp-httpx":{
"command":"uv",
"args":[
"--directory",
"path_of_the_repo/mcp-httpx/src/mcp-httpx",
"run",
"server.py"
]
}
}
}
Using Docker
To run the MCP server via Docker, add the following configuration to your claude_desktop_config.json:
{
"mcpServers":{
"mcp-httpx":{
"command":"docker",
"args":[
"run",
"-i",
"--rm",
"--name",
"mcp-httpx",
"mcp/httpx"
]
}
}
}
License
This MCP server is licensed under the MIT License. You are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please refer to the LICENSE file in the project repository.
