Search Engines Proxy

🚀 多核心代理協議（MCP）項目文檔

多核心代理協議（Multi-Channel Proxy, MCP）是一項創新技術，它通過整合多個搜索引擎和網絡信息源，極大地增強了AI助手的信息檢索能力。該系統支持Brave、Metaso和博查等多個搜索引擎，還配備了強大的搜索功能和結果分析工具。

🚀 快速開始

多核心代理協議（MCP）能有效提升AI助手的信息檢索能力。以下為你介紹如何快速搭建和使用該項目。

📦 安裝指南

安裝步驟

1. 克隆代碼庫：

git clone https://github.com/yourusername/mcp.git
cd mcp

2. 安裝依賴項：

pip install -r requirements.txt

3. 初始化配置文件：

python setup.py init-config

環境變量設置

創建一個.env文件並添加以下內容：

BRAVE_API_KEY=your_brave_api_key_here
METASO_API_KEY=your_metaso_api_key_here
BOCHA_API_KEY=your_bocha_api_key_here

✨ 主要特性

核心組件

1. MCP服務器 (server.py)
   • 提供RESTful API接口。
   • 負責協調不同搜索引擎的任務分配和結果聚合。
2. 搜索引擎代理 (proxy/) 包括Brave、Metaso和博查三個模塊，分別處理各引擎的搜索請求。

搜索引擎實現

Brave搜索模塊 (brave/)

• client.py: 定義與Brave搜索API交互的核心客戶端。
• config.py: 配置參數和速率限制策略。
• exceptions.py: 處理特定於Brave API調用的異常。

Metaso搜索模塊 (metaso/)

• client.py: 實現與Metaso搜索服務的通信邏輯。
• config.py: 定義配置參數及訪問控制規則。
• exceptions.py: 管理Metaso API調用中的錯誤處理。

博查搜索模塊 (bocha/)

• client.py: 提供博查搜索引擎的交互接口。
• config.py: 配置和優化博查API的使用參數。
• exceptions.py: 處理博查API特有的異常情況。

💻 使用示例

工具配置

1. Brave搜索工具 (brave_search.py)
2. Metaso搜索工具 (metaso_search.py)
3. 博查搜索工具 (bocha_search.py)

操作流程

1. 啟動MCP服務器：

python server.py start

2. 調用搜索接口：
   • 使用curl命令或HTTP客戶端發送請求。

搜索示例

基礎用法

發送GET請求：

curl http://localhost:8080/search?q=人工智能&engine=brave,metaso

響應結果：

{
  "status": "success",
  "results": [
    {
      "url": "https://example.com/1",
      "title": "AI基礎教程",
      "snippet": "介紹機器學習基本概念..."
    },
    ...
  ]
}

🔧 技術細節

項目結構

search/
├── __init__.py
├── server.py              # MCP服務器實現
└── proxy/                 # 搜索引擎代理
    ├── brave/             # Brave搜索模塊
    │   ├── __init__.py
    │   ├── client.py      # 核心客戶端實現
    │   ├── config.py      # 配置和速率限制
    │   └── exceptions.py  # 異常定義
    ├── metaso/            # Metaso搜索模塊
    │   ├── __init__.py
    │   ├── client.py      # 核心客戶端實現
    │   ├── config.py      # 配置和速率限制
    │   └── exceptions.py  # 異常定義
    └── bocha/              # 博查搜索模塊
        ├── __init__.py
        ├── client.py       # 核心客戶端實現
        ├── config.py       # 配置和優化參數
        └── exceptions.py   # 錯誤處理邏輯

接口定義

請求格式

{
  "query": "搜索關鍵詞",
  "engine": ["brave", "metaso", "bocha"],
  "params": {
    // 可選參數，如排序方式、結果數量等
  }
}

響應格式

{
  "status": "success",
  "results": [
    {
      "url": "鏈接地址",
      "title": "標題",
      "snippet": "簡要描述"
    },
    ...
  ]
}

⚠️ 注意事項

⚠️ 重要提示

確保API密鑰安全，避免洩露。

💡 使用建議

定期更新依賴庫以獲取最新功能和安全補丁。

通過以上文檔，您可以詳細瞭解如何搭建和使用MCP項目來增強AI助手的信息檢索能力。