Baidu MCP Server

🚀 Baidu 搜索 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

利用可能なツール

基本的な使用法

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

戻り値： クリーンアップされたフォーマット済みのテキストコンテンツ。

📚 ドキュメント

レート制限

• 検索：1分あたり最大30回のリクエスト
• コンテンツ取得：1分あたり最大20回のリクエスト
• 自動キュー管理と待機時間

結果処理

• 広告や関係のないコンテンツを削除
• 百度のリダイレクトリンクをクリーンアップ
• 大規模言語モデルの使用体験を最適化するために結果をフォーマット
• 長いテキストを適切に切り捨てる

エラー処理

• 包括的なエラー捕捉と報告
• MCP コンテキストを通じた詳細なログ記録
• レート制限やタイムアウトの場合にはエレガントなデグレードを実現

🔧 貢献

問題の報告やプルリクエストは大歓迎です！以下は潜在的な改善方向です。

• より多くの検索パラメータ（地域、言語など）を追加
• コンテンツ解析オプションを向上
• 一般的なコンテンツのキャッシュ層を追加
• 追加のレート制限策略を実装

📄 ライセンス

このプロジェクトは MIT License の下でオープンソース化されています。

謝辞

@Evilran がこのプロジェクトに貢献してくれたことに感謝します。