使用说明

项目简介

HTTP-4-MCP 中间件服务器是一个桥梁，它能够将传统的 HTTP API 接口转换为符合 Model Context Protocol (MCP) 标准的工具 (Tools)。通过简单的配置，用户可以将任何 HTTP API 封装成 MCP 工具，使得 LLM 客户端能够以标准化的方式调用这些 API，扩展 LLM 的能力边界。该项目提供友好的可视化配置界面，支持 JSON 配置、SSE 数据流、热重载等特性，旨在简化 HTTP API 向 MCP 工具的转换过程。

主要功能点

HTTP API 转换为 MCP 工具: 一键将现有的 HTTP API 转换为 MCP 工具，无需修改原有 API 代码。
可视化配置界面: 提供直观的 Web UI，通过图形化操作配置 API 工具，降低使用门槛。
JSON 配置: 支持通过 JSON 文件配置 API 工具，方便自动化和版本管理。
SSE 支持: 支持 Server-Sent Events (SSE) 协议，实现实时数据流传输。
热重载: 修改配置后无需重启服务器即可生效，提高开发效率。
完整的监控和日志: 提供详细的日志记录和错误跟踪，方便问题排查。

安装步骤

克隆仓库:

git clone https://github.com/Tght1211/http-4-mcp.git
cd http-4-mcp

或

git clone https://gitee.com/tght1211/http-for-mcp-server.git
cd http-for-mcp-server

安装依赖 (推荐使用 uv 包管理器):

uv venv
uv pip install -r requirements.txt

服务器配置

对于 MCP 客户端，需要配置连接到 HTTP-4-MCP 服务器的信息。以下是一个 JSON 格式的配置示例，用于配置一个名为 "http-mcp-server" 的服务器：

{
  "serverName": "http-mcp-server",
  "command": "python",
  "args": [
    "run.py"
  ],
  "transport": {
    "type": "sse",
    "url": "http://localhost:8000/mcp/sse"
  }
}

配置参数说明:

'serverName': 服务器名称，可以自定义。
'command': 启动服务器的命令，通常为 'python'。
'args': 启动命令的参数，这里指定运行 'run.py' 脚本。
'transport.type': 传输协议类型，这里使用 'sse' (Server-Sent Events)。
'transport.url': SSE 连接的 URL，默认为 'http://localhost:8000/mcp/sse'。请确保与 HTTP-4-MCP 服务器实际运行地址和端口一致。

注意:

确保 MCP 客户端能够访问到 HTTP-4-MCP 服务器的地址和端口。
可以根据实际情况修改 'args' 中的参数，例如指定不同的配置文件路径。

基本使用方法

启动 HTTP-4-MCP 服务器:

激活虚拟环境:

source .venv/bin/activate  # Linux/Mac
.venv/Scripts/activate  # Windows

运行主服务器:
```
uv run run.py
```
服务器默认运行在 'http://0.0.0.0:8000'。

启动可视化配置 UI (可选):
- 运行配置 UI:
```
uv run run_config_ui.py
```
  配置 UI 默认运行在 'http://localhost:8002'。
配置 API 工具:
- 通过可视化 UI (推荐): 访问 'http://localhost:8002'，通过 Web 界面添加、编辑和管理 API 工具。
- 直接编辑 JSON 配置文件: 修改 'config/apis.json' 文件，手动配置 API 工具。
连接 MCP 客户端:
- 在 MCP 客户端中，配置连接到 HTTP-4-MCP 服务器，使用上述 服务器配置 中的 JSON 配置信息。
- MCP 客户端将可以通过 SSE 协议与 HTTP-4-MCP 服务器通信，并调用配置好的 HTTP API 工具。
使用 MCP 工具:
- 在 LLM 应用中，通过 MCP 客户端调用已配置的工具名称，即可间接调用对应的 HTTP API 获取数据或执行操作。

关键词