🚀 HTTP-4-MCP 中间件服务器

<div align="center">

English | 中文

</div>

🌟 简介

HTTP-4-MCP 是一个强大的中间件服务器，能够神奇地转换常规 HTTP 接口为 MCP (模型控制协议) 接口。通过简单的配置，您的 HTTP API 立即变成一个 MCP 工具！

✨ 主要特性

• 🔄 HTTP 转 MCP: 一键将 HTTP API 转换为 MCP 接口
• 📝 JSON 配置: 简单直观的配置
• 🌊 SSE 支持: 实时数据流
• 🎨 可视化配置: 拖拽式 API 配置界面
• 🔥 热重载: 无需重启即可立即更新配置
• 📊 完整监控: 详细的日志记录和错误跟踪
• 🛡️ 安全可靠: 内置错误处理和参数验证

👨‍💻 作者信息

<div align="center">

</div>

📸 系统演示

<div align="center">

🖥️ 直观的可视化配置界面

🔄 强大的 API 转换

📊 cURL 导入支持

🚀 工具描述

</div>

🚀 快速开始

📦 安装

# 克隆仓库
git clone https://gitee.com/tght1211/http-for-mcp-server.git
# 或 git clone https://github.com/tght1211/http-for-mcp-server.git

cd http-for-mcp-server

# 安装依赖 (推荐使用 uv 包管理器)
uv venv
uv pip install -r requirements.txt

🎮 启动服务

# 激活虚拟环境
.venv/Scripts/activate  # Windows
source .venv/bin/activate  # Linux/Mac

# 启动主服务器
uv run run.py

# 启动配置 UI (可选)
uv run run_config_ui.py

🎯 使用指南

1️⃣ 配置 API

方法 1: 🎨 可视化配置 (推荐)

1. 访问 http://localhost:8002
2. 点击 "Add New Interface"
3. 填写配置参数
4. 保存并立即应用！

方法 2: 📝 JSON 配置

{
  "tools": [
      {
          "name": "weather_api",
          "description": "获取指定城市的实时天气信息，包括温度、湿度、天气状况、风向和风速。\n    \n    此工具使用两步查询过程：\n    1. 首先，通过城市名称获取精确的位置 ID\n    2. 然后，使用位置 ID 查询实时天气数据\n    \n    使用示例：\n    - 获取“北京”的天气信息\n    - 获取“上海”的实时天气状况\n    - 查询“广州”的温度和湿度\n    \n    返回格式化的天气信息文本，包括城市名称、天气状况、温度、湿度、风向和风速。",
          "url": "https://devapi.qweather.com/v7/weather/now",
          "method": "GET",
          "params": {
              "location": {
                  "type": "string",
                  "desc": "城市名称或 ID",
                  "required": true,
                  "default": "101010100"
              },
              "key": {
                  "type": "string",
                  "desc": "API 密钥",
                  "required": true,
                  "default": "05a3e2c04b65416e912088b76a7a487e"
              },
              "lang": {
                  "type": "string",
                  "desc": "语言",
                  "required": false,
                  "default": "zh"
              },
              "unit": {
                  "type": "string",
                  "desc": "单位制",
                  "required": false,
                  "default": "m"
              }
          },
          "headers": {
              "User-Agent": "weather-app/1.0"
          },
          "response": {
              "code": {
                  "path": "code",
                  "desc": "响应状态码"
              },
              "updateTime": {
                  "path": "updateTime",
                  "desc": "数据更新时间"
              },
              "fxLink": {
                  "path": "fxLink",
                  "desc": "详细天气信息链接"
              },
              "now": {
                  "path": "now",
                  "desc": "实时天气数据对象"
              },
              "now_obsTime": {
                  "path": "now.obsTime",
                  "desc": "实际观测时间"
              },
              "now_temp": {
                  "path": "now.temp",
                  "desc": "当前温度（摄氏度）"
              },
              "now_feelsLike": {
                  "path": "now.feelsLike",
                  "desc": "体感温度（摄氏度）"
              },
              "now_icon": {
                  "path": "now.icon",
                  "desc": "天气图标代码"
              },
              "now_text": {
                  "path": "now.text",
                  "desc": "天气现象文本描述"
              },
              "now_wind360": {
                  "path": "now.wind360",
                  "desc": "风向 360 度角"
              },
              "now_windDir": {
                  "path": "now.windDir",
                  "desc": "风向描述"
              },
              "now_windScale": {
                  "path": "now.windScale",
                  "desc": "风力等级"
              },
              "now_windSpeed": {
                  "path": "now.windSpeed",
                  "desc": "风速（公里/小时）"
              },
              "now_humidity": {
                  "path": "now.humidity",
                  "desc": "相对湿度百分比"
              },
              "now_precip": {
                  "path": "now.precip",
                  "desc": "降水量（毫米）"
              },
              "now_pressure": {
                  "path": "now.pressure",
                  "desc": "大气压（百帕）"
              },
              "now_vis": {
                  "path": "now.vis",
                  "desc": "能见度（公里）"
              },
              "now_cloud": {
                  "path": "now.cloud",
                  "desc": "云量百分比"
              },
              "now_dew": {
                  "path": "now.dew",
                  "desc": "露点温度（摄氏度）"
              }
          },
          "response_mode": "metadata"
      }
  ]
}

2️⃣ 连接到 MCP

# SSE 连接 URL
ws_url = "http://localhost:8000/mcp/sse"

🛠️ 项目结构

📦 http-for-mcp-server
 ┣ 📂 config/            # 配置文件
 ┣ 📂 demo/             # 示例代码
 ┣ 📂 static/           # 静态资源
 ┣ 📜 mcp_server.py     # 主服务器
 ┣ 📜 config_ui.py      # 配置 UI
 ┣ 📜 run.py           # 启动脚本
 ┗ 📜 requirements.txt  # 依赖

📚 配置参考

🔧 全局配置

配置	描述	默认值
🌐 host	服务器地址	"0.0.0.0"
🔌 port	服务器端口	8000
🐛 debug	调试模式	false
📝 log_level	日志级别	"info"

🎉 特色功能

🔄 cURL 导入

直接粘贴 cURL 命令，自动生成配置：

curl -X GET 'https://api.example.com/weather?city=beijing'

🎨 像素画界面

• 🎮 游戏化的配置体验
• 🎯 拖拽式参数设置
• 📊 实时请求测试
• 🔄 自动生成配置

🤝 贡献指南

1. 🍴 Fork 本仓库
2. 🔧 创建特性分支
3. 📝 提交更改
4. 🚀 推送分支
5. 📬 提交 Pull Request

📞 获取帮助

• 📧 提交 Issue
• 💬 加入讨论组
• 📚 查看 Wiki

📄 开源许可

本项目使用 MIT 许可证 - 参见 LICENSE 文件

---

<div align="center"> ⭐️ 如果此项目对您有帮助，请给一个 star！⭐️ </div>