Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client