Serper Search

🚀 MCP サーバー Serper

このプロジェクトは、Python をベースにした MCP（モデルコンテキストプロトコル）サーバーで、API Serper を通じたウェブ検索を行うことができます。

🚀 クイックスタート

この MCP サーバーは、Python で実装され、API Serper を利用してウェブ検索を行います。以下の手順でサーバーをセットアップして使用することができます。

✨ 主な機能

• Server-Sent Events (SSE) の送信
• API Serper を通じたウェブ検索
• ウェブページ内容の抽出
• サービスの健康状態チェック

📦 インストール

前提条件

• Python 3.8 以上
• Serper API アカウント（https://serper.dev）

インストール手順

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

git clone https://github.com/seu-usuario/mcp-server-serper.git
cd mcp-server-serper

2. プロジェクトをインストールします。

pip install -e .

📚 ドキュメント

設定

プロジェクトのルートディレクトリに .env ファイルを作成し、以下の変数を含めます。

SERPER_API_KEY=sua_chave_api_serper
MCP_TOKEN=seu_token_autenticacao  # オプション
HOST=127.0.0.1  # オプション、デフォルト：127.0.0.1
PORT=3001  # オプション、デフォルト：3001

使用方法

サーバーの起動

mcp-server-serper

または、Python を直接使用して実行します。

python -m mcp_server_serper.main

サーバーへの接続

サーバーは以下のエンドポイントを公開しています。

• GET /：基本情報ページを表示します。
• GET /sse：MCP クライアントに接続するための SSE エンドポイントです。
• POST /messages：クライアントからのメッセージを受け取ります。

利用可能なツール

• google_search：Serper API を通じたウェブ検索を行います。
• scrape：ウェブページの内容を抽出します。
• _health：サービスの健康状態をチェックします。

開発

1. 開発用の依存関係をインストールします。

pip install -e ".[dev]"

2. テストを実行します。

pytest

3. コードの品質をチェックします。

black .
isort .
mypy src
flake8

📄 ライセンス

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