MCP Server Search

🚀 MCP 服務器搜索

這是一個具備 Google 搜索功能的 MCP（模型上下文協議）服務器，藉助它，AI 模型能夠從網絡獲取最新信息。

🚀 快速開始

此 MCP 服務器可助力 AI 模型從網絡獲取最新信息，下面為你介紹其使用的相關內容。

✨ 主要特性

• 集成 Google 搜索，還具備緩存功能。
• 可對請求延遲和重試進行配置，以此避免限流。
• 支持簡單搜索和高級搜索（帶描述）。
• 限制流量並隨機化，做良好的網絡公民。

📦 安裝指南

使用 Docker（推薦）

1. 構建 Docker 鏡像：

docker build -t mcp-server-search .

2. 創建持久化所需的目錄：

mkdir -p ./logs ./cache

3. 運行容器：

docker run --rm -i \
  -v "$(pwd)/logs:/app/logs" \
  -v "$(pwd)/cache:/app/cache" \
  mcp-server-search

這些卷能確保：

• 日誌持久化到 ./logs 目錄。
• 搜索緩存持久化到 ./cache 目錄。
• 若目錄不存在，Docker 會自動創建。

⚠️ 重要提示： -i 標誌用於 MCP 協議通信，--rm 會在容器退出後自動刪除容器。

Cline 集成

若要將此 MCP 服務器與 Cline 一起使用，請在 Cline 的 MCP 設置文件（對於 VS Code，位於 ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json）中添加以下配置：

{
    "mcpServers": {
        "google_search": {
            "command": "docker",
            "args": [
                "run",
                "--rm",
                "-i",
                "mcp-server-search"
            ],
            "disabled": false,
            "alwaysAllow": []
        }
    }
}

此配置：

• 設置搜索 MCP 服務器在 Docker 容器中運行。
• 使用 --rm 標誌以便在容器退出時自動刪除。
• 使用 -i 開啟交互模式，這是 MCP 協議所需。
• 默認禁用服務器（將 disabled 設置為 false 可啟用）。
• 需要顯式批准所有工具使用（alwaysAllow 為空）。

📚 詳細文檔

配置

該服務器接受以下命令行參數：

使用說明

該服務器暴露以下 MCP 端點：

工具

• google_search：執行 Google 搜索並返回結果。結果以帶標題、URL 和描述的 Markdown 格式呈現（若啟用）。
  • 參數：
    • query (字符串，必需)：要執行的搜索查詢。
    • num_results (整數，可選)：要返回的結果數量（最小值：1，最大值：20，默認：5）。
    • use_cache (布爾，可選)：若緩存中有可用結果是否使用（默認：true）。
    • include_descriptions (布爾，可選)：是否包含描述（默認：true）。
  • 特性：
    • 具備自動請求節流和重試機制。
    • 用戶代理隨機化，實現更好的請求分佈。
    • 支持帶文件系統的緩存訪問。
    • 限制流量。

配置示例

在 mcp-server-search 容器中運行時，可通過以下命令傳遞參數：

docker run --rm -i \
    -v "$(pwd)/logs:/app/logs" \
    -v "$(pwd)/cache:/app/cache" \
    mcp-server-search \
    --log-level INFO \
    --log-file /app/logs/search.log \
    --cache-path /app/cache/google_cache.db \
    --request-delay 2 \
    --max-retries 3

配置文件

默認情況下，服務器從 config.json 加載配置。以下是一個示例：

{
    "log_level": "INFO",
    "log_file": "./logs/search.log",
}