higress api gateway.com
higress api gateway.com logo

Higress API Gateway

Enables DevOps teams to manage Higress API gateway configurations through natural language commands with human-in-the-lo...

Created byApr 23, 2025

Higress OPS MCP Server

A Model Context Protocol (MCP) server implementation that enables comprehensive configuration and management of [Higress](https://higress.cn/). This repository also provides an MCP client built on top of [LangGraph](https://www.langchain.com/langgraph) and [LangChain MCP Adapters](https://github.com/langchain-ai/langchain-mcp-adapters), facilitating interaction with the Higress MCP Server through a well-designed agent flow architecture.

Demo

https://github.com/user-attachments/assets/bae66b77-a158-452e-9196-98060bac0df7

Config Environment Variables

Copy the `.env.example` file to `.env` and fill in the corresponding values.

Start MCP Client and MCP Server

In stdio mode, the MCP server process is started by the MCP client program. Run the following command to start the MCP client and MCP server:

Add a new tool

**Step 1: Create a new tool class or extend an existing one**
  • Create a new file in the tools directory if adding a completely new tool category
  • Or add your tool to an existing class if it fits an existing category
**Step 2: Add a new method to HigressClient if your tool needs to interact with the Higress Console API**
  • Add methods to utils/higress_client.py that encapsulate API calls
  • Use the existing HTTP methods (get, put, post) for actual API communication
**Step 3: Register your tool class in the server**
  • Add your tool class to the tool_classes list in server.py
  • This list is used by ToolsRegister to instantiate and register all tools
  • The ToolsRegister will automatically set logger and higress_client attributes
**Step 4: Add your tool to `SENSITIVE_TOOLS` if it requires human confirmation**
  • Tools in this list will require human confirmation before execution