返回 MCP 目录
public公开dns本地运行

haproxy-mcp-server

HAProxy MCP Server是一个基于Go语言实现的HAProxy模型上下文协议服务器,通过HAProxy运行时API和mcp-go库,为大型语言模型提供标准化的HAProxy管理接口,支持自然语言交互进行负载均衡器管理、监控和流量分析。

article

README

🚀 HAProxy MCP 服务器

HAProxy MCP 服务器是一个强大的工具,它能为 HAProxy 提供多种运行模式和管理功能,支持不同的传输协议,可帮助用户更高效地管理和配置 HAProxy。

🚀 快速开始

HAProxy MCP 服务器可以通过不同的方式进行安装和运行,下面为你详细介绍。

📦 安装指南

编译运行

# 使用 HTTP 运行 HAProxy MCP 服务器
go build -o bin/haproxy-mcp-server cmd/server/main.go

# 使用 stdio 运行 HAProxy MCP 服务器
HAPROXY_HOST=<your-haproxy-host> HAPROXY_PORT=9999 LOG_LEVEL=info MCP_TRANSPORT=stdio ./bin/haproxy-mcp-server

# 使用 HTTP 运行 HAProxy MCP 服务器
MCP_PORT=8080 LOG_LEVEL=info MCP_TRANSPORT=http ./bin/haproxy-mcp-server

安装位置及配置

# 将 MCP 服务器二进制文件移动到指定目录(例如 /usr/local/bin)
mv haproxy-mcp-server /usr/local/bin/

# 创建配置文件并设置权限(例如 /etc/haproxy_mcp_server.json)
touch /etc/haproxy_mcp_server.json
chmod 600 /etc/haproxy_mcp_server.json

# 将 MCP 服务器添加到服务管理器(例如 systemd)
nano /etc/systemd/system/haproxy-mcp-server.service

💻 使用示例

基础用法

# 以 TCP 模式运行 HAProxy MCP 服务器
HAPROXY_HOST=<your-haproxy-host> HAPROXY_PORT=9999 LOG_LEVEL=info MCP_TRANSPORT=tcp ./bin/haproxy-mcp-server

# 以 Unix Socket 模式运行 HAProxy MCP 服务器
HAPROXY_RUNTIME_MODE=unix HAPROXY_RUNTIME_SOCKET=/path/to/haproxy.sock LOG_LEVEL=info MCP_TRANSPORT=socket ./bin/haproxy-mcp-server

# 使用 HTTP 运行 HAProxy MCP 服务器
MCP_PORT=8080 LOG_LEVEL=info MCP_TRANSPORT=http ./bin/haproxy-mcp-server

高级用法

MCP 工具列表

# 列出所有可用的 MCP 工具
curl -X POST http://localhost:8080/jsonrpc \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"listTools","params":{}}'

调用 MCP 工具

# 调用 show_info 工具
curl -X POST http://localhost:8080/jsonrpc \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"callTool","params":{"name":"show_info","arguments":{}}}'

✨ 主要特性

  • 多种运行模式:支持 TCP、Unix Socket 和 HTTP 等多种运行模式,满足不同场景的需求。
  • MCP 工具管理:提供了列出和调用 MCP 工具的功能,方便用户进行管理和配置。
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端