Baidu MCP Server

🚀 百度搜索MCP服务器

一个提供百度搜索功能的模型上下文协议（MCP）服务器，具备内容获取和解析的额外功能，能为大语言模型提供友好的输出格式。

🚀 快速开始

本项目是一个提供百度搜索功能的模型上下文协议（MCP）服务器，可用于网页搜索、内容获取等场景。你可以按照以下步骤进行安装和使用。

✨ 主要特性

• 网页搜索：通过百度进行高级速率限制和结果格式化
• 内容获取：检索并解析网页内容，具备智能文本提取功能
• 速率限制：内置搜索和内容获取的防护机制
• 错误处理：全面的错误处理和日志记录
• 大语言模型友好的输出格式：专为大型语言模型设计的结果格式

📦 安装指南

通过 Smithery 安装

使用 Smithery 自动安装适用于Claude Desktop的Baidu搜索服务器：

npx -y @smithery/cli install @Evilran/baidu-mcp-server --client claude

通过 uv 安装

直接从PyPI使用 uv 安装：

uv pip install baidu-mcp-server

💻 使用示例

配置 Claude Desktop

1. 下载 Claude Desktop
2. 创建或编辑你的Claude Desktop配置文件：
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

添加以下配置：

{
    "mcpServers": {
        "baidu-search": {
            "command": "uvx",
            "args": ["baidu-mcp-server"]
        }
    }
}

3. 重启 Claude Desktop

开发

本地开发时，可以使用MCP CLI：

# 使用 MCP Inspector 运行
mcp dev server.py

# 为测试安装到本地环境
mcp install server.py

基础用法

搜索工具

async def search(query: str, max_results: int = 10) -> str

在百度上执行网页搜索并返回格式化结果。

参数：

• query: 搜索查询字符串
• max_results: 返回的最大结果数（默认值：10）

返回： 包含标题、链接和片段的格式化字符串。

内容获取工具

async def fetch_content(url: str) -> str

抓取并解析网页内容。

参数：

• url: 要抓取内容的网页 URL

返回： 清理后的格式化文本内容。

📚 详细文档

可用工具

1. 搜索工具

async def search(query: str, max_results: int = 10) -> str

在百度上执行网页搜索并返回格式化结果。

参数：

• query: 搜索查询字符串
• max_results: 返回的最大结果数（默认值：10）

返回： 包含标题、链接和片段的格式化字符串。

2. 内容获取工具

async def fetch_content(url: str) -> str

抓取并解析网页内容。

参数：

• url: 要抓取内容的网页 URL

返回： 清理后的格式化文本内容。

功能详述

速率限制

• 搜索：每分钟最多30次请求
• 内容获取：每分钟最多20次请求
• 自动队列管理和等待时间

结果处理

• 移除广告和无关内容
• 清理百度跳转链接
• 格式化结果以优化大语言模型的使用体验
• 适当截断长文本

错误处理

• 全面错误捕捉和报告
• 详细日志通过MCP上下文记录
• 在速率限制或超时情况下实现优雅降级

🔧 技术细节

本项目通过内置的防护机制实现了搜索和内容获取的速率限制，同时具备全面的错误处理和日志记录功能。在结果处理方面，会移除广告和无关内容、清理百度跳转链接、格式化结果以优化大语言模型的使用体验，并适当截断长文本。

🤝 贡献

欢迎提出问题和拉取请求！以下是一些潜在的改进方向：

• 添加更多搜索参数（地区、语言等）
• 提升内容解析选项
• 增加常用内容的缓存层
• 实现额外的速率限制策略

📄 许可证

此项目在MIT License下开源。

🙏 致谢

感谢 @Evilran 为本项目做出的贡献。