Python MCP Server 8u4

🚀 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」を検索し、関連する内容が返されます。

利用可能なライブラリ

• LangChain：ドキュメントはlangchain.comにあります。
• LlamaIndex：ドキュメントはllamaindex.aiにあります。
• OpenAI：ドキュメントはplatform.openai.comにあります。

📚 ドキュメント

コード概要

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キーを読み込みます。
• デバッグレベルのログを提供し、サーバーの操作と潜在的な問題をよりよく理解できるようにします。