Smolagents MCPs

🚀 SmolAgents + MCP サーバー

このプロジェクトは、SmolAgents ライブラリを使用して、Web検索を実行し、ウェブサイトを取得/クロールできるAIアシスタントを構築する方法を示しています。これは、Brave Search と Crawl4ai のモデルコンテキストプロトコル (MCP) サーバーを統合することで実現されます。

🚀 クイックスタート

このプロジェクトを実行するには、以下の手順に従ってください。

✨ 主な機能

• AIアシスタントを使用して、Web検索を実行し、ウェブサイトを取得/クロールできます。
• Brave Search と Crawl4ai の MCP サーバーを統合しています。
• コードは、Python クラス (SmolAgentWithMCP) を使用して、エージェントの初期化と主要な対話ループをカプセル化しています。このオブジェクト指向のアプローチにより、モジュール化された設計が提供され、エージェントの機能を拡張することが容易になります。

📦 インストール

前提条件

このプロジェクトを実行する前に、以下の依存関係をインストールしてください。

• smolagents
• python-dotenv
• mcp
• @modelcontextprotocol/server-brave-search（npm/npx を使用してグローバルにインストール）
• litellm

Python パッケージは、pip を使用してインストールできます。

pip install -r requirements.txt

MCP サーバーを実行するには、Node.js と npm/npx および uv がインストールされていることを確認してください。

環境変数

プロジェクトのルートディレクトリに .env ファイルを作成し、以下の変数を追加してください。

BRAVE_API_KEY=your_brave_api_key
OPENAI_API_KEY=your_openai_api_key

your_brave_api_key と your_openai_api_key を実際の API キーに置き換えてください。

💻 使用例

基本的な使用法

1. リポジトリをクローンするか、スクリプト (smolagent_with_mcp.py) をダウンロードします。
2. ターミナルでプロジェクトディレクトリに移動します。
3. スクリプトを実行します。

python smolagent_with_mcp.py

4. 検索クエリを入力して、アシスタントと対話します。exit または quit を入力すると、セッションが終了します。

高度な使用法

smolagent_with_mcp.py ファイルの構造により、MCP サーバーとそのツールをモジュール化された方法で簡単に追加できます。新しい MCP サーバーを追加するには、以下の手順に従ってください。

1. 新しいサーバーの StdioServerParameters を定義します。これには、サーバーを実行するコマンド、そのパラメーター、および必要な環境変数を指定する必要があります（brave_server_params と crawl4ai_server_params の定義方法と同様）。
2. 新しく定義されたサーバーパラメーターオブジェクトを main 関数内の server_list に追加します。BraveSearchAgentApp クラスは、新しいサーバーを自動的に初期化し、そのツールをエージェントの機能に含めます。

# 定義新服务器的参数（用实际命令和参数替换）
new_server_params = StdioServerParameters(
    command="your_server_command",
    args=["arg1", "arg2"],
    env={"YOUR_API_KEY": os.getenv("YOUR_API_KEY")},
)

def main():
    # 定义 MCP 服务器参数列表
    server_list = [
        brave_server_params,
        crawl4ai_server_params,
        new_server_params
    ]
    
    # 初始化代理并运行
    agent = SmolAgentWithMCP(server_list)
    agent.run()

if __name__ == "__main__":
    main()

📚 ドキュメント

備考

• Brave Search MCP サーバーを実行するには、npx がインストールされており、システムの PATH で使用できることを確認してください。
• SmolAgents の ToolCallingAgent は、構造化された形式（JSON など）でツール呼び出しを出力するように設計されています。これらの呼び出しは、環境によって実行されます（この例では、メインスクリプトのメインループで MCPClient を使用して実行されます）。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されており、コードを自由に使用、変更、配布することができます。