HTTP-MCP配置工具

你是否曾经希望将现有的HTTP API快速转换为MCP工具，而无需编写复杂的代码？今天要介绍的开源项目HTTP-MCP配置工具，正是为了实现这个目标而设计的。它是一个强大的中间件服务器，可以神奇地转换普通的HTTP接口为MCP接口，通过简单的配置，让您的HTTP API立刻变成一个MCP工具。

项目基本信息

一、项目介绍

HTTP-MCP配置工具是一个让用户能够轻松将HTTP API转换为MCP工具的中间件服务器。它提供可视化配置界面，支持JSON配置、SSE实时数据流、热重载等功能。

这个工具的核心特性包括：

• HTTP到MCP一键转换
• JSON配置
• SSE实时数据流
• 可视化配置界面
• 热重载
• cURL导入支持
• 全面监控和错误跟踪

二、核心优势

零代码转换

通过可视化界面或JSON配置，无需编写代码即可将HTTP API转换为MCP工具。

cURL导入

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

实时预览

配置后立即测试，无需重启。

热重载

即时更新配置，无需重启服务器。

全面监控

详细的日志记录和错误跟踪。

三、适用场景

API快速集成

将现有的HTTP API快速转换为MCP工具，供AI使用。

原型开发

快速验证API集成方案，无需编写MCP服务器代码。

第三方API接入

将第三方服务的HTTP API转换为MCP工具。

内部系统集成

将内部系统的HTTP接口暴露给AI助手。

四、安装教程

系统要求

安装步骤

第一步：克隆项目并安装依赖

git clone https://github.com/MCP-Mirror/Tght1211_http-4-mcp.git
cd http-for-mcp-server
uv venv
uv pip install -r requirements.txt

第二步：启动服务

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

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

# 启动配置UI（可选）
uv run run_config_ui.py

第三步：配置API

方法一：可视化配置（推荐）

1. 访问http://localhost:8002
2. 点击“添加新接口”
3. 填写配置参数
4. 保存并立即应用

方法二：JSON配置

创建配置文件，参考示例格式。

第四步：连接到MCP客户端

SSE连接地址：http://localhost:8000/mcp/sse

配置Claude Desktop：

{
  "mcpServers": {
    "http-mcp": {
      "url": "http://localhost:8000/mcp/sse"
    }
  }
}

五、使用示例

示例1：天气API配置

JSON配置示例：

{
  "tools": [
    {
      "name": "weather_api",
      "description": "获取指定城市的实时天气信息",
      "url": "https://devapi.qweather.com/v7/weather/now",
      "method": "GET",
      "params": {
        "location": {
          "type": "string",
          "desc": "城市名称或ID",
          "required": true
        },
        "key": {
          "type": "string",
          "desc": "API密钥",
          "required": true
        }
      },
      "response": {
        "temp": {
          "path": "now.temp",
          "desc": "当前温度"
        },
        "text": {
          "path": "now.text",
          "desc": "天气现象"
        }
      }
    }
  ]
}

示例2：cURL导入

粘贴cURL命令：

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

工具会自动解析并生成配置。

示例3：使用生成的MCP工具

配置完成后，在AI客户端中：

用户指令：“获取北京的天气信息”

AI会调用转换后的天气API工具。

六、配置参数说明

七、常见问题

问题1：服务器启动失败

解决方案：检查端口是否被占用，修改配置中的端口。

问题2：cURL导入解析失败

解决方案：确保cURL命令格式正确。

问题3：API调用返回错误

解决方案：检查API密钥和参数是否正确。

问题4：MCP客户端连接失败

解决方案：确认SSE地址正确，服务器正在运行。

问题5：热重载不生效

解决方案：检查配置文件格式，保存后会自动重载。

八、总结

HTTP-MCP配置工具是一个让用户能够零代码将HTTP API转换为MCP工具的中间件服务器，提供可视化配置界面和cURL导入功能。

这个项目的最大价值在于：

1. 零代码转换：无需编写代码
2. 可视化配置：界面操作简单
3. cURL导入：自动生成配置
4. 热重载：即时生效
5. MIT许可证：可自由使用

如果你需要快速将HTTP API转换为MCP工具，HTTP-MCP配置工具是一个非常实用的解决方案。