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 為本項目做出的貢獻。