HTTPX MCP Server
About
The HTTPX MCP Server helps to perform REST API operations in your AI worklfows
Details
- Author
- avishekjana-89
- Downloads
- 352
- Categories
- Other
Jump to
- GET, POST, PUT, PATCH, DELETE HTTP methods
- Optional token and headers for authenticated requests
- Returns URL, status code, and response body
- Installable via uv or Docker
- Integrates with Claude Desktop via MCP
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
HTTPX MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Clone the repository from GitHub, then install via uv (uv pip install .) or build a Docker image (docker build -t mcp/httpx .). Configure the server in your claude_desktop_config.json using either the uv command or the Docker command as shown in the README.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"httpx mcp server": {
"mcp-httpx": {
"command": "uv",
"args": [
"pip",
"install",
"."
]
}
}
}
}McpServers
{
"mcp-httpx": {
"command": "uv",
"args": [
"pip",
"install",
"."
]
}
}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 GET request for the specified URL.
- Arguments:
- url: A structured URL with scheme, host, and path (e.g., https://example.com/path?query=value).
- Returns: A dictionary containing the URL, status code, and the response body.
post_request
- Description: Executes a POST request 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 PUT request 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 PATCH request 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 DELETE request 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",
"parent_of_servers_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.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
