使用说明

项目简介

本项目 'baidu-mcp-server' 是一个实现了 Model Context Protocol (MCP) 的服务器，旨在为大型语言模型 (LLM) 应用提供 Baidu 搜索引擎的访问能力。通过集成此 MCP 服务器，LLM 客户端可以调用预设的工具，利用 Baidu 搜索互联网信息，并抓取网页内容，从而增强 LLM 的知识获取和信息整合能力。

主要功能点

Baidu 网页搜索: 支持通过 Baidu 搜索引擎进行关键词搜索，并返回格式化的搜索结果，方便 LLM 理解和使用。
网页内容抓取: 能够根据 URL 抓取网页内容，并提取出主要文本信息，去除 HTML 标签和无关内容，为 LLM 提供更干净的文本输入。
速率限制: 内置速率限制机制，防止因频繁请求 Baidu 搜索服务或抓取网页内容而被封禁，保证服务的稳定性和可持续性。
结果优化: 对搜索结果和抓取内容进行处理和格式化，使其更适合 LLM 的理解和处理，例如去除广告、优化 URL、提取摘要等。

安装步骤

安装 'baidu-mcp-server': 使用 'uv pip' 包管理器进行安装。打开终端，执行以下命令：

uv pip install baidu-mcp-server

或者，您也可以使用 'pip' 进行安装：

pip install baidu-mcp-server

服务器配置

要将 'baidu-mcp-server' 集成到 MCP 客户端（例如 Claude Desktop），您需要配置客户端的 MCP 服务器设置。以下是 Claude Desktop 的配置示例，您需要编辑 Claude Desktop 的配置文件 'claude_desktop_config.json'，添加 'mcpServers' 配置项：

macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%\Claude\claude_desktop_config.json'

在配置文件中，添加如下 JSON 配置：

{
    "mcpServers": {
        "baidu-search": {  // 服务器名称，可以自定义，例如 "baidu-search"
            "command": "uvx", // 运行命令，这里使用 uvx (如果使用 pip 安装，可以尝试使用 python 或 python3，根据您的环境配置)
            "args": ["baidu-mcp-server"] // 命令参数，指定运行 baidu-mcp-server
        }
    }
}

注意:

'"baidu-search"': 是您为该服务器定义的名称，在客户端中引用时会用到。您可以自定义名称。
'"command": "uvx"' 和 '"args": ["baidu-mcp-server"]': 指定了启动 'baidu-mcp-server' 的命令。'uvx baidu-mcp-server' 表示使用 'uvx' 运行 'baidu-mcp-server' 可执行程序。请确保您的环境中 'uvx' (或您选择的 python 运行命令) 可用，并且 'baidu-mcp-server' 已正确安装。

配置完成后，重启您的 MCP 客户端 (Claude Desktop) 使配置生效。

基本使用方法

成功配置并启动 'baidu-mcp-server' 后，在您的 MCP 客户端中，您应该可以使用以下工具：

Search Tool (search): 用于执行 Baidu 网页搜索。
- 参数:
  - 'query': 搜索关键词 (字符串类型)
  - 'max_results': 最大返回结果数量 (整数类型，默认为 6)
  - 'deep_mode': 是否进行深度内容抓取 (布尔类型，默认为 False)。如果设置为 'true'，服务器会抓取搜索结果页面的内容并返回摘要，可能会增加请求时间和资源消耗。
- 使用示例 (在 Claude 中): '@baidu-search/search query="最新的科技新闻" max_results=5'
此命令将使用 "最新的科技新闻" 作为关键词在 Baidu 上进行搜索，并返回最多 5 条结果。

请根据您的 MCP 客户端的具体使用方式调用 'search' 工具，利用 Baidu 搜索功能增强 LLM 的能力。

关键词