Higress Ai Search MCP Server

🚀 Higress AI-Search MCP Server

A Model Context Protocol (MCP) server that provides AI search tools. It leverages the ai-search feature of Higress to fetch information from multiple search engines in real-time and enhance AI model responses.

🚀 Quick Start

Prerequisites

• Use uv for package installation.
• Configure Higress and use the ai-search and ai-proxy plugins.

Configuration

The server can be configured via environment variables:

• HIGRESS_URL (optional): The URL of the Higress service (default value is http://localhost:8080/v1/chat/completions).
• MODEL (required): The LLM model to use.
• INTERNAL_KNOWLEDGE_BASES (optional): A description of the internal knowledge bases.

Option 1: Use uvx

Using uvx will automatically install the package from PyPI without the need to clone the repository locally.

{
  "mcpServers": {
    "higress-ai-search-mcp-server": {
      "command": "uvx",
      "args": [
        "higress-ai-search-mcp-server"
      ],
      "env": {
        "HIGRESS_URL": "http://localhost:8080/v1/chat/completions",
        "MODEL": "qwen-turbo",
        "INTERNAL_KNOWLEDGE_BASES": "Employee handbook, company policies, internal process documents"
      }
    }
  }
}

Option 2: Use uv for local development

Using uv requires cloning the repository locally and specifying the source code path.

{
  "mcpServers": {
    "higress-ai-search-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/src/higress-ai-search-mcp-server",
        "run",
        "higress-ai-search-mcp-server"
      ],
      "env": {
        "HIGRESS_URL": "http://localhost:8080/v1/chat/completions",
        "MODEL": "qwen-turbo",
      }
    }
  }
}

✨ Features

• Internet Search: Google, Bing, Quark - for general web information.
• Academic Search: Arxiv - for scientific papers and research.
• Internal Knowledge Search

💻 Usage Examples

Console

https://github.com/user-attachments/assets/60a06d99-a46c-40fc-b156-793e395542bb

Claude Desktop

https://github.com/user-attachments/assets/5c9e639f-c21c-4738-ad71-1a88cc0bcb46