Higress Ops
A Model Context Protocol (MCP) server implementation that enables comprehensive configuration and management of Higress.
What is Higress Ops?
Higress Ops is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol (mcp) server implementation that enables comprehensive configuration and management of higress.
A Model Context Protocol (MCP) server implementation that enables comprehensive configuration and management of Higress.
This server falls under the Cloud Services and Developer Tools categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Model Context Protocol (MCP) server implementation that en
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx higress-opsConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Higress Ops
Higress Ops MCP Server is a Python-based MCP server that enables AI agents to configure and manage the Higress cloud-native API gateway through natural language. It wraps the Higress Console REST API across four tool categories — common operations, request blocking, route management, and service source configuration — and includes built-in human confirmation gates for sensitive mutations like adding or updating routes. DevOps teams and platform engineers use it to manage API gateway configuration conversationally instead of navigating the Higress web UI or writing raw API calls.
Prerequisites
- Python 3.10 or later and 'uv' package manager installed ('pip install uv' or 'brew install uv')
- A running Higress instance accessible from the machine running the MCP server (default: http://localhost:8001)
- Higress Console credentials (username and password)
- An MCP-compatible client such as Claude Desktop
- Optional: an OpenAI-compatible API key if using the LLM-assisted features
Clone the repository
Clone the higress-ops-mcp-server repository to your local machine.
git clone https://github.com/higress-group/higress-ops-mcp-server.git
cd higress-ops-mcp-serverCopy and configure the environment file
Copy the example environment file and fill in your Higress instance URL and credentials. All three Higress variables are required.
cp .env.example .env
# Then edit .env with your values:
# HIGRESS_URL=http://localhost:8001
# HIGRESS_USERNAME=admin
# HIGRESS_PASSWORD=your-password
# OPENAI_API_KEY=sk-... (optional)
# OPENAI_API_BASE=https://api.openai.com/v1 (optional)
# MODEL_NAME=gpt-4o (optional)Install dependencies
Use 'uv' to install all Python dependencies into an isolated environment.
uv syncStart the server and verify connectivity
Launch the MCP server using uv run. It starts in stdio mode and connects to your Higress instance.
uv run client.pyConfigure your MCP client
Add the server to your claude_desktop_config.json, passing the project directory so the .env file is found.
{
"mcpServers": {
"higress-ops": {
"command": "uv",
"args": ["run", "--directory", "/absolute/path/to/higress-ops-mcp-server", "client.py"]
}
}
}Higress Ops Examples
Client configuration
claude_desktop_config.json entry for Higress Ops MCP server using uv.
{
"mcpServers": {
"higress-ops": {
"command": "uv",
"args": ["run", "--directory", "/Users/you/higress-ops-mcp-server", "client.py"],
"env": {
"HIGRESS_URL": "http://localhost:8001",
"HIGRESS_USERNAME": "admin",
"HIGRESS_PASSWORD": "your-password"
}
}
}
}Prompts to try
Example prompts for managing Higress routes, services, and request blocking.
- "List all routes currently configured in Higress."
- "Add a new route that forwards /api/v2/* traffic to my backend service at http://backend:8080."
- "Block all requests containing 'sqlmap' in the User-Agent header."
- "Show me all service sources registered in Higress."
- "Update the timeout for the /api/slow-endpoint route to 60 seconds."Troubleshooting Higress Ops
Connection refused when the server tries to reach Higress
Verify HIGRESS_URL in your .env file is correct and that the Higress Console is running. Try 'curl http://localhost:8001/v1/health' from the same machine to confirm connectivity.
'uv' command not found
Install uv with 'pip install uv' or on macOS with 'brew install uv'. After installing, close and reopen your terminal so the PATH is updated.
Sensitive operations like add_route are not executing
The server requires explicit human confirmation before executing mutations. When prompted in Claude, respond affirmatively to confirm the operation. This is an intentional safety gate, not a bug.
Frequently Asked Questions about Higress Ops
What is Higress Ops?
Higress Ops is a Model Context Protocol (MCP) server that model context protocol (mcp) server implementation that enables comprehensive configuration and management of higress. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Higress Ops?
Follow the installation instructions on the Higress Ops GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Higress Ops?
Higress Ops works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Higress Ops free to use?
Yes, Higress Ops is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Higress Ops Alternatives — Similar Cloud Services Servers
Looking for alternatives to Higress Ops? Here are other popular cloud services servers you can use with Claude, Cursor, and VS Code.
Open WebUI
★ 138.2kUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)
Anything LLM
★ 60.4kThe all-in-one AI productivity accelerator. On device and privacy first with no annoying setup or configuration.
LocalAI
★ 46.4kLocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.
Nacos
★ 33.0kan easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.
Xiaozhi ESP32
★ 26.7k本项目为xiaozhi-esp32提供后端服务，帮助您快速搭建ESP32设备控制服务器。Backend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server.
Gateway
★ 11.8kA blazing fast AI Gateway with integrated guardrails. Route to 1,600+ LLMs, 50+ AI Guardrails with 1 fast & friendly API.
Browse More Cloud Services MCP Servers
Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Higress Ops in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Higress Ops?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.