Document Search MCP Server

🚀 Python MCP サーバ - ドキュメント検索

このサーバは、シンプルなMCP（最小命令プロトコル）サーバです。ユーザーはSerper APIを通じて、LangChain、LlamaIndex、OpenAIなどの人気ライブラリのドキュメントを検索することができます。HTTPリクエストとBeautifulSoupを使用して、ウェブページから検索結果を取得し、関連するドキュメント内容を抽出します。

✨ 主な機能

• LangChain、LlamaIndex、OpenAIのドキュメント内での検索をサポート。
• Serper APIを使用したウェブ検索の実行。
• 関連するドキュメントページからテキスト内容を抽出して返す。
• MCPプロトコルを通じた対話的な使用が可能。

📦 インストール

ステップ1：Pythonの依存関係をインストール

プロジェクトをセットアップするには、このリポジトリをクローンし、必要な依存関係をインストールします。

git clone <repository-url>
cd <repository-directory>
pip install -r requirements.txt

または、requirements.txtファイルを使用しない場合は、以下のコマンドを実行します。

pip install httpx beautifulsoup4 mcp python-dotenv

ステップ2：環境変数を設定

プロジェクトのルートディレクトリに.envファイルを作成し、Serper APIキーを追加します。

SERPER_API_KEY=your-serper-api-key-here

dotenvパッケージを使用して.envファイルを読み込むことを確認してください。

ステップ3：サーバを起動

設定が完了したら、以下のコマンドでサーバを起動します。

uv run main.py

サーバが起動し、入力を待機します。

💻 使用例

基本的な使用法

サーバが起動したら、特定のライブラリの最新のドキュメントを照会するために使用できます。以下はツール呼び出しの例です。

# サーバを起動
uv run main.py

別のターミナルまたは対話型MCPクライアント内から、get_docsツールを呼び出してドキュメントを検索します。

get_docs("Chroma DB", "langchain")

これにより、LangChainのドキュメント内で"Chroma DB"を検索し、関連する内容が返されます。

利用可能なライブラリ

📚 ドキュメント

コード概要

main.py

• FastMCP：MCPサーバを初期化します。
• Tools：このサーバには2つのツールがあります。
  • dummy_tool：サーバが正常に動作していることを確認するための単純なツール。
  • get_docs：指定されたクエリとライブラリ（LangChain、LlamaIndex、OpenAI）の最新のドキュメントを取得します。
• search_web()：Serper APIを使用した検索を処理します。
• fetch_url()：URLを取得し、BeautifulSoupを使用してテキスト内容を抽出します。

dotenv と logging

• .envファイルからSerper APIキーを読み込みます。
• デバッグレベルのログを提供し、サーバの操作と潜在的な問題をよりよく理解できるようにします。