Langgraph-MCP Client for Postgresql Example

PostgreSQL の例向け Langgraph-MCP クライアント

このリポジトリでは、LangGraph エージェント向けに PostgreSQL データベースへ接続した MCP サーバーを Docker イメージとして利用する方法を、非常に低レベルな例で紹介します。

モデルコンテキストプロトコル

MCP は、アプリケーションが LLM にコンテキストを提供する方法を標準化するオープンプロトコルです。MCP は、AI アプリケーション向けの USB-C ポートのようなものと考えてください。USB-C がさまざまな周辺機器やアクセサリーにデバイスを接続する標準的な方法を提供するように、MCP は AI モデルをさまざまなデータソースやツールに接続する標準的な方法を提供します。

---

前提条件

始める前に、以下がシステムにインストールされていることを確認してください。

• Docker
• PostgreSQL Database - 起動済みで、データが投入されていること
• MCP Servers

---

フローとツール

• 設定を通じて Postgresl MCP サーバーが認識できる PostgreSQL データベースを使用します
• from langchain_mcp_adapters.tools import load_mcp_tools は MCP ツールを作成します
• create_react_agent は高速なエージェントテンプレーターです
• ストリームをファイルに出力します

プロジェクトのセットアップ手順

1. リポジトリをクローンする

このリポジトリをローカルマシンにクローンします。

git clone https://github.com/your-repo/Langchain-MCP.git
cd Langgraph-mcp-client directory

2. .env ファイルを作成する

リポジトリのルートに、以下の変数を含む .env ファイルを作成します。

DB_HOST=<your-database-host>
DB_PORT=<your-database-port>
DB_USER=<your-database-username>
DB_PASSWORD=<your-database-password>
DB_NAME=<your-database-name>

プレースホルダーを、実際のデータベースおよび MCP サーバーの接続情報に置き換えてください。

3. UV パッケージをインストールする

まだインストールしていない場合は、UV パッケージをグローバルにインストールします。

Astral uv

---

MCP サーバーのセットアップ

1. リポジトリ MCP Servers を別のディレクトリにクローンします
2. docker build -t mcp/postgres -f src/postgres/Dockerfile . を実行して、イメージをビルドし、タグ付けします

使用手順

1. UV パッケージを同期する

次のコマンドを実行して、UV パッケージを同期します。

uv sync

このコマンドにより、UV パッケージがパッケージを正しくインストールします。

2. クエリエージェントを実行する

次のコマンドを使用してクエリエージェントを起動します。

uv run queryagent

ユーザーのクエリを入力するよう求められます。

代替 - クエリを指定（バンキングデータベース）

uv run queryagent "Who holds the most funds in thier account?"

---

TODO：

• 出力のフォーマット
• マルチエージェント

トラブルシューティング

• データベース接続：.env ファイルに正しいデータベース認証情報が含まれていることを確認してください。
• UV パッケージのエラー：UV CLI がグローバルにインストールされていて、uv sync コマンドがエラーなく完了することを確認してください。

---

コントリビューション

このリポジトリの改善に役立つ課題の報告やプルリクエストの送信を歓迎します。

---

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細については、LICENSE ファイルを参照してください。