MCP 服务器搜索

这是一个提供 Google 搜索功能的 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 设置文件（位于 ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json 对于 VS Code）中添加以下配置：

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

此配置：

• 设置搜索 MCP 服务器在 Docker 容器中运行
• 使用 --rm 标志以自动删除容器退出时
• 使用 -i 进行交互模式，MCP 协议所需
• 默认禁用服务器（设置 disabled 为 false 启用）
• 需要显式批准所有工具使用（alwaysAllow 空）

配置

该服务器接受以下命令行参数：

• --log-level：设置日志等级（DEBUG、INFO、WARNING、ERROR、CRITICAL）。默认：INFO
• --log-file：日志文件路径（默认：标准输出）
• --cache-path：搜索缓存文件路径（默认：cache/google_cache.db）
• --request-delay：搜索请求之间的延迟时间（秒，默认：5）
• --max-retries：失败搜索的最大重试次数（默认：3）

使用说明

该服务器暴露以下 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",