article

README

Higress AI-Search MCP Server

Overview

A Model Context Protocol (MCP) server that provides an AI search tool to enhance AI model responses with real-time search results from various search engines through Higress ai-search feature.

Demo

Cline

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

Claude Desktop

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

Features

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

Prerequisites

uv for package installation.
Config Higress with ai-search plugin and ai-proxy plugin.

Configuration

The server can be configured using environment variables:

HIGRESS_URL(optional): URL for the Higress service (default: http://localhost:8080/v1/chat/completions).
MODEL(required): LLM model to use for generating responses.
INTERNAL_KNOWLEDGE_BASES(optional): Description of internal knowledge bases.

Option 1: Using uvx

Using uvx will automatically install the package from PyPI, no 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: Using uv with local development

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

{
  "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",
        "INTERNAL_KNOWLEDGE_BASES": "Employee handbook, company policies, internal process documents"
      }
    }
  }
}

License

This project is licensed under the MIT License - see the LICENSE file for details.

Higress AI 智能搜索服务