http2mcp

把 HTTP 接口快速封装为 MCP Tool，并通过可视化管理界面维护工具配置、发布 MCP 服务、查看调用日志。

功能概览

• 可视化创建/编辑工具（URL、Header、Query、Body、参数、响应提取）。
• 支持三种 HTTP 调用模式：
  • single：单接口调用。
  • and：多接口并发调用，全部成功后合并结果。
  • or：按 orParam 参数分支，只执行匹配步骤。
• 支持从 cURL 导入工具配置（含参数自动提取）。
• 工具调用日志可追溯（含错误信息、HTTP 诊断、调用参数等）。
• 工具可设置“生效/未生效”，发布后仅暴露生效工具。

环境要求

• Go 1.24.6（见 go.mod）

快速开始

1) 安装依赖

go mod tidy

2) 启动管理界面

go run . -port 8080 -data ./data

参数说明：

• -port：管理界面端口，默认 8080
• -data：数据目录，默认是可执行文件同级 data/

启动后访问：

• http://localhost:8080

编译运行

1) 编译

在项目根目录执行：

go build -o http2mcp .

Windows 可执行文件示例：

go build -o http2mcp.exe .

2) 运行已编译程序

./http2mcp -port 8080 -data ./data

Windows:

.\http2mcp.exe -port 8080 -data .\data

3) 交叉编译（可选）

# Linux amd64
GOOS=linux GOARCH=amd64 go build -o dist/http2mcp-linux-amd64 .

# macOS arm64
GOOS=darwin GOARCH=arm64 go build -o dist/http2mcp-darwin-arm64 .

# Windows amd64
GOOS=windows GOARCH=amd64 go build -o dist/http2mcp-windows-amd64.exe .

使用流程

1. 在“工具列表”中创建工具（或 cURL 导入）。
2. 配置传输方式（SSE / Streamable HTTP / Stdio）。
3. 点击“发布 MCP 服务”。
4. 在 MCP 客户端连接发布地址并调用工具。

数据与日志

默认数据目录结构（-data 指定目录下）：

• config.json：服务与工具配置
• logs/{toolId}.log：工具调用日志（每行一条 JSON）
• logs/sequences.json：每个工具的调用序号计数

说明：

• 调用日志会按策略保留最近记录，旧日志可能被裁剪。
• 日志中的 logSeq 为单调递增序号，可用于定位“第几次调用”。

工具截图

常见问题

工具发布后在 MCP 客户端看不到？

• 检查该工具是否被设为“未生效”；
• 检查是否已重新点击“发布 MCP 服务”；
• 检查客户端连接的是当前发布的传输地址。

配错 URL 时为什么日志少？

项目已对错误路径做了兜底记录；若仍异常，检查进程输出中的 tool call log 相关错误日志。

许可证

见 LICENSE.txt。