README.md•8.78 kB
[](https://mseep.ai/app/tght1211-http-4-mcp)
# 🚀 HTTP-4-MCP Middleware Server
<div align="center">
[English](README.md) | [中文](README_CN.md)
</div>
## 🌟 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
## 👨💻 Author Information
<div align="center">
[](https://github.com/tght1211)
[](https://gitee.com/tght1211)
</div>
## 📸 System Demo
<div align="center">
### 🖥️ Intuitive Visual Configuration Interface
### 🔄 Powerful API Conversion
### 📊 cURL Import Support
### 🚀 Tool Description
</div>
## 🚀 Quick Start
### 📦 Installation
```bash
# 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
```bash
# 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)
1. Visit `http://localhost:8002`
2. Click "Add New Interface"
3. Fill in configuration parameters
4. Save and apply instantly!
#### Method 2: 📝 JSON Configuration
```json
{
"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
```python
# 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:
```bash
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
1. 🍴 Fork this repository
2. 🔧 Create feature branch
3. 📝 Submit changes
4. 🚀 Push branch
5. 📬 Submit Pull Request
## 📞 Get Help
- 📧 Submit Issue
- 💬 Join Discussion Group
- 📚 View Wiki
## 📄 Open Source License
This project uses the MIT license - see [LICENSE](LICENSE) file
---
<div align="center">
⭐️ If this project helps you, please give a star!⭐️
</div>