Ksrk Mcp Server Client について
Ksrk Mcp Server Clientは、ksrkに関する情報を検索するMCPサーバーと、GPT-4を使う対話型Pythonクライアントです。Web検索とページ内容の取得に対応しています。
主な機能
- 01ScrapingDogによるWeb検索
- 02URLのページ内容取得
- 03サイトを指定したksrk情報検索
- 04GPT-4による対話型クエリループ
活用シーン
- 01ksrkに関するWeb情報の検索
- 02URLのページ内容の取得と確認
MCP 対応
MCPサーバーはWeb検索、URL取得、about_ksrkツールを公開します。付属クライアントはサーバーに接続してツールを呼び出し、GPT-4でクエリを処理します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
要件
- Python 3.13
pyproject.tomlに記載されている依存関係
インストール
-
リポジトリをクローンします。
git clone <repository-url> cd documentation -
仮想環境を作成して有効化します。
python -m venv .venv source .venv/bin/activate # On Windows use `.venv\Scripts\activate` -
依存関係をインストールします。
pip install -r requirements.txt -
環境変数を設定します。
ルートディレクトリに
.envファイルを作成し、次の内容を記述します。SCRAPING_DOG_API_KEY=your_scraping_dog_api_key OPENAI_API_KEY=your_openai_api_key
使い方
クライアントの実行
-
ルートディレクトリに移動します。
cd .. -
クライアントを実行します。
python client.py -
対話型プロンプトループにプロンプトを入力します。クライアントを停止するには、
quitまたはexitと入力します。
プロジェクトファイル
client.py
このファイルには、MCP サーバーおよび OpenAI の GPT-4 モデルと連携するメインのクライアントコードが含まれています。主な構成要素は次のとおりです。
MCPClient:MCP サーバーへの接続を管理し、利用可能なツールを取得して呼び出すメソッドを提供するクラスです。agent_loop:LLM と利用可能なツールを使用してユーザーのクエリを処理する非同期関数です。main:MCP サーバーを設定し、ツールを初期化して、対話型ループを実行するメイン関数です。
ksrk-mcp/ksrk-mcp-server.py
このファイルには、MCP サーバーの実装が含まれています。主な構成要素は次のとおりです。
search_web:ScrapingDog API を使用してウェブを検索する非同期関数です。fetch_url:URL のコンテンツを取得する非同期関数です。about_ksrk:指定されたウェブサイトで「ksrk」に関する詳細を検索する MCP ツールです。
ksrk-mcp/test-website.py
このファイルには、httpx と BeautifulSoup を使用してウェブサイトのスクレイピングをテストするスクリプトが含まれています。
ライセンス
このプロジェクトは MIT ライセンスのもとでライセンスされています。詳細については、LICENSE ファイルをご覧ください。
謝辞
- GPT-4 モデルを提供している OpenAI。
- ウェブスクレイピング API を提供している ScrapingDog。
- HTML および XML ドキュメントの解析に使用する BeautifulSoup。
- HTTP クライアントである httpx。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。