Supports importing cURL commands to automatically generate API configurations, allowing users to easily convert existing HTTP requests into MCP tools.
Enables access to the project repository on Gitee, offering an alternative source for cloning and accessing the HTTP-4-MCP server codebase.
Provides integration with GitHub repositories for cloning and accessing the HTTP-4-MCP server codebase.
Built on Python 3.8+, enabling Python-based setup and execution of the HTTP-4-MCP middleware server.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@http-4-mcpconfigure a weather API endpoint for city forecasts"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
๐ HTTP-4-MCP Middleware Server
๐ Introduction
HTTP-4-MCP is a powerful middleware server that magically transforms regular HTTP interfaces into MCP (Model Control Protocol) interfaces. With simple configuration, your HTTP API becomes an MCP tool instantly!
โจ Key Features
๐ HTTP to MCP: One-click conversion of HTTP APIs to MCP interfaces
๐ JSON Configuration: Simple and intuitive configuration
๐ SSE Support: Real-time data streaming
๐จ Visual Configuration: Drag-and-drop interface for API configuration
๐ฅ Hot Reload: Instant configuration updates without restart
๐ Complete Monitoring: Detailed logging and error tracking
๐ก๏ธ Secure & Reliable: Built-in error handling and parameter validation
Related MCP server: Meta MCP Server
๐จโ๐ป Author Information
๐ธ System Demo
๐ฅ๏ธ Intuitive Visual Configuration Interface
๐ Powerful API Conversion
๐ cURL Import Support
๐ Tool Description
๐ Quick Start
๐ฆ Installation
# Clone repository
git clone https://gitee.com/tght1211/http-for-mcp-server.git
# or git clone https://github.com/tght1211/http-for-mcp-server.git
cd http-for-mcp-server
# Install dependencies (recommended using uv package manager)
uv venv
uv pip install -r requirements.txt๐ฎ Start Service
# Activate virtual environment
.venv/Scripts/activate # Windows
source .venv/bin/activate # Linux/Mac
# Start main server
uv run run.py
# Start configuration UI (optional)
uv run run_config_ui.py๐ฏ Usage Guide
1๏ธโฃ Configure API
Method 1: ๐จ Visual Configuration (Recommended)
Visit
http://localhost:8002Click "Add New Interface"
Fill in configuration parameters
Save and apply instantly!
Method 2: ๐ JSON Configuration
{
"tools": [
{
"name": "weather_api",
"description": "Get real-time weather information for a specified city, including temperature, humidity, weather conditions, wind direction, and wind speed.\n \n This tool uses a two-step query process:\n 1. First, get the precise location ID through city name\n 2. Then, query real-time weather data using the location ID\n \n Example usage:\n - Get weather information for \"Beijing\"\n - Get real-time weather conditions for \"Shanghai\"\n - Query temperature and humidity for \"Guangzhou\"\n \n Returns formatted weather information text, including city name, weather conditions, temperature, humidity, wind direction, and wind speed.",
"url": "https://devapi.qweather.com/v7/weather/now",
"method": "GET",
"params": {
"location": {
"type": "string",
"desc": "City name or ID",
"required": true,
"default": "101010100"
},
"key": {
"type": "string",
"desc": "API key",
"required": true,
"default": "05a3e2c04b65416e912088b76a7a487e"
},
"lang": {
"type": "string",
"desc": "Language",
"required": false,
"default": "zh"
},
"unit": {
"type": "string",
"desc": "Unit system",
"required": false,
"default": "m"
}
},
"headers": {
"User-Agent": "weather-app/1.0"
},
"response": {
"code": {
"path": "code",
"desc": "Response status code"
},
"updateTime": {
"path": "updateTime",
"desc": "Data update time"
},
"fxLink": {
"path": "fxLink",
"desc": "Detailed weather information link"
},
"now": {
"path": "now",
"desc": "Real-time weather data object"
},
"now_obsTime": {
"path": "now.obsTime",
"desc": "Actual observation time"
},
"now_temp": {
"path": "now.temp",
"desc": "Current temperature (Celsius)"
},
"now_feelsLike": {
"path": "now.feelsLike",
"desc": "Feels like temperature (Celsius)"
},
"now_icon": {
"path": "now.icon",
"desc": "Weather icon code"
},
"now_text": {
"path": "now.text",
"desc": "Weather phenomenon text description"
},
"now_wind360": {
"path": "now.wind360",
"desc": "Wind direction 360-degree angle"
},
"now_windDir": {
"path": "now.windDir",
"desc": "Wind direction description"
},
"now_windScale": {
"path": "now.windScale",
"desc": "Wind scale"
},
"now_windSpeed": {
"path": "now.windSpeed",
"desc": "Wind speed (km/h)"
},
"now_humidity": {
"path": "now.humidity",
"desc": "Relative humidity percentage"
},
"now_precip": {
"path": "now.precip",
"desc": "Precipitation (mm)"
},
"now_pressure": {
"path": "now.pressure",
"desc": "Atmospheric pressure (hPa)"
},
"now_vis": {
"path": "now.vis",
"desc": "Visibility (km)"
},
"now_cloud": {
"path": "now.cloud",
"desc": "Cloud coverage percentage"
},
"now_dew": {
"path": "now.dew",
"desc": "Dew point temperature (Celsius)"
}
},
"response_mode": "metadata"
}
]
}2๏ธโฃ Connect to MCP
# SSE connection URL
ws_url = "http://localhost:8000/mcp/sse"๐ ๏ธ Project Structure
๐ฆ http-for-mcp-server
โฃ ๐ config/ # Configuration files
โฃ ๐ demo/ # Example code
โฃ ๐ static/ # Static resources
โฃ ๐ mcp_server.py # Main server
โฃ ๐ config_ui.py # Configuration UI
โฃ ๐ run.py # Startup script
โ ๐ requirements.txt # Dependencies๐ Configuration Reference
๐ง Global Configuration
Configuration | Description | Default |
๐ host | Server address | "0.0.0.0" |
๐ port | Server port | 8000 |
๐ debug | Debug mode | false |
๐ log_level | Log level | "info" |
๐ Special Features
๐ cURL Import
Paste cURL command directly, automatically generate configuration:
curl -X GET 'https://api.example.com/weather?city=beijing'๐จ Pixel Art Interface
๐ฎ Game-like configuration experience
๐ฏ Drag-and-drop parameter setting
๐ Real-time request test
๐ Automatically generate configuration
๐ค Contribution Guide
๐ด Fork this repository
๐ง Create feature branch
๐ Submit changes
๐ Push branch
๐ฌ Submit Pull Request
๐ Get Help
๐ง Submit Issue
๐ฌ Join Discussion Group
๐ View Wiki
๐ Open Source License
This project uses the MIT license - see LICENSE file