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",
}