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

Author Information

System Demo

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

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

{
  "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 namen    2. Then, query real-time weather data using the location IDn    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"
      }
  ]
}

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

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 file

If this project helps you, please give a star!