Model Context Protocol (mcp) Server

🚀 使用 LangChain / Python の MCP クライアント

このシンプルな Model Context Protocol (MCP) クライアントは、LangChain ReAct Agent による MCP サーバーツールの使用をデモンストレートします。langchain_mcp_tools パッケージのユーティリティ関数 convert_mcp_to_langchain_tools() を利用しており、この関数は指定された複数の MCP サーバーを並列で初期化し、それらの利用可能なツールを LangChain 互換のツールリスト（List[BaseTool]）に変換します。

現在、Anthropic、OpenAI、Groq の大規模言語モデル (LLMs) がサポートされています。

TypeScript 版の MCP クライアントはこちらで見つけることができます：here

🚀 クイックスタート

✨ 主な機能

• 簡単な Model Context Protocol (MCP) クライアントで、LangChain ReAct Agent が MCP サーバーツールを使用するデモを提供します。
• langchain_mcp_tools パッケージの convert_mcp_to_langchain_tools() 関数を利用して、複数の MCP サーバーを初期化し、LangChain 互換のツールリストに変換します。
• Anthropic、OpenAI、Groq の大規模言語モデル (LLMs) をサポートしています。

📦 インストール

前提条件

• Python 3.11+
• [オプション] Python パッケージベースの MCP サーバーを実行するには uv（または uvx）をインストールする
• [オプション] Node.js パッケージベースの MCP サーバーを実行するには npm 7+ をインストールする（または npx を使用する）
• 必要に応じて、Anthropic、OpenAI、および/または Groq から API キーを取得する

インストール手順

1. 依存関係をインストールする：

make install

2. API キーを設定する：

cp .env.template .env

• 必要に応じて .env ファイルを更新する。
• .gitignore は .env を無視するように設定されており、クレデンシャルの誤ったコミットを防ぎます。

3. 必要に応じて、LLM と MCP サーバーの設定 llm_mcp_config.json5 を構成する。

• 設定ファイル形式 MCP サーバーは Claude for Desktop と同じ構造に従いますが、JSON 設定ファイルで一般的なスネークケース命名法に合わせて、キー名 mcpServers を mcp_servers に変更しています。
• ファイル形式は JSON5 で、コメントと末尾のカンマが許可されています。
• 形式はさらに拡張されており、${...} プレースホルダーを対応する環境変数値に置き換えます。
• すべてのクレデンシャルと個人情報は .env ファイルに保存し、${...} 記号を使用して必要な値を参照します。

💻 使用例

アプリケーションを実行する

make start

初回実行には少し時間がかかります。

デバッグモードで実行する

make start-v

コマンドラインオプションを表示する

make start-h

プロンプトでは、直接エンターキーを押すことでサンプルクエリを使用でき、これらのクエリは MCP サーバーツールの呼び出しを実行します。サンプルクエリは llm_mcp_config.json5 で構成できます。