Reactmcp

🚀 再定義検索：ReActMCP Web Search 日本語版

ReActMCP Web Searchは、AIアシスタントフレームワーク向けに設計された強力なウェブ検索ツールです。基本的および高度なウェブ検索機能を提供し、MCP（マルチツール制御プロトコル）インターフェースを通じて他のAIツールとシームレスに統合されます。

🚀 クイックスタート

ReActMCP Web Searchは、AIアシスタントフレームワークに最適化されたウェブ検索ツールです。基本的および高度なウェブ検索機能を提供し、MCPインターフェースを通じて他のAIツールと連携できます。

✨ 主な機能

• search_web：基本的なウェブ検索を実行します。
• advanced_search_web：フィルタオプション付きの高度なウェブ検索を行います。
• キーワード、URL制限など、複数の検索パラメータをサポートします。

📦 インストール

プロジェクト構造

ReActMCP Web Search/
├── servers/                  # MCP サーバー実装ディレクトリ
│   └── web_search.py        # ウェブ検索サービスのメインファイル
├── requirements.txt         # 必要な Python パッケージの依存関係
└── README.md                # プロジェクトドキュメント

インストール手順

1. リポジトリをクローンします：

git clone https://github.com/yourusername/ReActMCP.git
cd ReActMCP/Web-Search

2. 依存関係をインストールします：

pip install -r requirements.txt

📚 ドキュメント

環境変数の設定

.env ファイルを使用して、以下の環境変数を設定してください：

EXA_API_KEY=your_api_key_here

システム設定の例

web_search.py では、デフォルトの設定パラメータを見つけることができます。必要に応じて以下の内容を調整してください：

class WebSearchConfig:
    BASE_URL = "https://api.example.com"
    API_KEY_NAME = "EXA_API_KEY"
    TIMEOUT = 10  # 秒

検索サーバーの起動

MCPサーバーは servers ディレクトリにあります。サーバーを起動するには：

python servers/web_search.py

このコマンドにより、MCPサーバーが起動し、リクエストを待ち受け、以下のツールを提供します：

• search_web：基本的なウェブ検索を実行します。
• advanced_search_web：フィルタオプション付きの高度なウェブ検索を行います。

テスト

web_search.py には、テスト関数 test_search() があります（現在はコメントアウトされています）。テストを実行するには、テスト実行ブロックのコメントを解除し、Pythonのasyncioランナーを使用します：

if __name__ == "__main__":
    import asyncio
    # 以下の行のコメントを解除してテスト検索を実行します
    # asyncio.run(test_search())
    mcp.run()

これにより、サンプルクエリの検索結果が表示され、ツールが正常に動作していることを確認できます。

Claude デスクトップの設定

config.json に以下の内容を追加して、このサーバーを使用します：

{
  "mcpServers": {
    "websearch": {
         "command": "python",
         "args": ["path/to/servers/exa_web_search.py"]
       }
  }
}

トラブルシューティング

• EXA_API_KEY が不足している：.env ファイルが正しく設定され、有効なExa APIキーが含まれていることを確認してください。
• 依存関係の問題：すべての必要なPythonパッケージがインストールされていることを確認してください（requirements.txt を参照）。必要に応じて、パッケージを再インストールしてください。
• API エラー：ウェブ検索を実行する際にエラーが発生した場合は、ネットワーク接続を確認し、Exa APIの状態を検証してください。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細については、LICENSE ファイルを参照してください。

貢献

貢献を歓迎します！何か提案、エラー修正、または改善点がある場合は、問題を開くか、プルリクエストを送信してください。

スター履歴