Higress OPS MCP Server

Higress OPS MCP Server

site icon
2025.03.29 1
Python配置管理自动化运维其它
Higress OPS MCP Server 是一个基于 Model Context Protocol (MCP) 的服务实现,用于全面配置和管理 [Higress](https://higress.cn/)。该服务还提供了一个基于 [LangGraph](https://www.langchain.com/langgraph) 和 [LangChain MCP Adapters](https://github.com/langchain-ai/langchain-mcp-adapters) 的 MCP 客户端,通过精心设计的代理流架构与 Higress MCP Server 进行交互。
View on GitHub

Overview

基本能力

产品定位

Higress OPS MCP Server 是一个用于配置和管理 Higress 的 MCP 服务,提供了一套工具和接口,方便用户通过 MCP 协议与 Higress 进行交互。

核心功能

  1. MCP 服务器实现:支持通过 MCP 协议配置和管理 Higress。
  2. MCP 客户端:基于 LangGraph 和 LangChain MCP Adapters,提供代理流架构的交互方式。
  3. 工具扩展:支持用户自定义工具类和方法,扩展功能。
  4. 敏感操作确认:支持对敏感操作进行人工确认,确保安全性。

适用场景

  1. Higress 配置管理:通过 MCP 协议动态配置 Higress 的路由、服务源等。
  2. 自动化运维:利用 MCP 客户端实现自动化运维任务。
  3. 工具扩展开发:开发自定义工具,扩展 Higress 的功能。

工具列表

  1. CommonTools:提供通用工具方法。
  2. RequestBlockTools:管理请求拦截插件。
  3. RouteTools:管理路由配置。
  4. ServiceSourceTools:管理服务源配置。
  5. 自定义工具:用户可以根据需求开发自定义工具类和方法。

常见问题解答

  1. 如何添加新工具?:按照文档中的步骤创建工具类、注册工具并添加到敏感工具列表(如果需要)。
  2. 如何启动 MCP 客户端和服务器?:在 stdio 模式下,通过 uv run client.py 命令启动。
  3. 如何配置环境变量?:复制 .env.example 文件到 .env 并填写相应值。

使用教程

使用依赖

  1. 确保已安装 Python 环境。
  2. 安装依赖库: bash pip install fastmcp langchain langgraph

安装教程

  1. 克隆仓库: bash git clone <repository-url> cd <repository-directory>
  2. 配置环境变量: bash cp .env.example .env 编辑 .env 文件,填写相应的配置值。
  3. 启动 MCP 客户端和服务器: bash uv run client.py

调试方式

  1. 检查日志输出,确保服务启动正常。
  2. 使用 MCP 客户端工具进行交互测试。
  3. 如果遇到问题,检查环境变量配置是否正确。

许可证

None