MCP + LangGraph Agent について
MCP + LangGraph Agentは、MCPサーバーをツールとして使うLangGraphエージェントの最小構成のチュートリアルです。開発者向けに、数学・天気サーバーの例と対話型CLIを含みます。
主な機能
- 01LangGraphの状態管理とメッセージルーティング
- 02MCPサーバーをエージェントのツールとして利用
- 03数学・天気サーバーのサンプル
- 04対話型コマンドラインインターフェース
- 05サーバーのトランスポート設定
活用シーン
- 01MCPツールを使うLangGraphエージェントの構築
- 02エージェントの状態とメッセージルーティングの確認
- 03ツールを使った数学・天気クエリの試用
MCP 対応
エージェントはMCPサーバーをツールとして利用します。例として数学・天気サーバーがあり、`src/main.py`で設定します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
MCP + LangGraph エージェント
これは、従来の LangChain ツールではなく、**MCP(Model Context Protocol)**サーバーを使って実装したツールを備える、LangGraph を利用したエージェントの最小限の実用例です。LangGraph の公式チュートリアルをもとに、MCP サーバーをツールとして統合する方法を紹介するために調整されています。
🧠 このリポジトリをひな形として使い、MCP ツールを備えた独自の LangGraph エージェントを手早く構築しましょう!
特長
flowchart TD
__start__ --> chatbot
chatbot -.-> tools
chatbot -.-> __end__
tools --> chatbot
- LangGraph を統合し、エージェントの状態とメッセージのルーティングを管理します。
- MCP サーバーを使ってツールにアクセスします。
- 数学と天気用の MCP サーバーのサンプルが含まれています。
- エージェントと対話するためのコマンドラインインターフェースを提供します。
インストール
-
リポジトリをクローンします。
git clone <repository_url> -
Poetry を使って依存関係をインストールします。
poetry install
使い方
-
.envファイルに Anthropic API キーを設定します。このファイルが存在しない場合は、作成が必要です。例:ANTHROPIC_API_KEY=your_api_key -
MCP サーバーを起動します。
- 数学サーバー:
python src/mcp_servers/math_server.py - 天気サーバー:
python src/mcp_servers/weather_server.py
- 数学サーバー:
-
エージェントを実行します。
poetry run mainエージェントが対話モードで起動します。プロンプトを入力すると、エージェントは MCP サーバーが提供するツールを使って応答します。
例
User: What's (3 + 5) x 12?
Assistant: The result of (3 + 5) × 12 = 96
User: What is the weather in New York?
Assistant: It's always sunny in New York.
MCP サーバーの設定
MCP サーバーはsrc/main.pyで設定されています。設定を変更して、サーバーを追加または削除したり、トランスポートの仕組みを変更したりできます。
LLM の設定
エージェントが使用する LLM はsrc/common.pyで変更できます。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。