Langgraph MCP Client

🚀 語言鏈-MCP 客戶端用於 PostgreSQL 示例

本倉庫展示了一個基礎示例，演示如何與運行在 Docker 鏡像中的 MCP 服務器進行交互。該鏡像連接到 PostgreSQL 數據庫，供 LangGraph 代理使用。

model context protocol

MCP 是一個開放協議，它對應用程序向大語言模型（LLM）提供上下文的方式進行了標準化。可以把 MCP 想象成 AI 應用程序的 USB - C 端口。就像 USB - C 為設備提供了一個通用接口來連接各種外圍設備和配件一樣，MCP 為 AI 模型提供了一個通用接口來連接不同的數據源和工具。

🚀 快速開始

✨ 主要特性

• 展示與運行在 Docker 鏡像中的 MCP 服務器交互的底層示例。
• 連接到 PostgreSQL 數據庫，供 LangGraph 代理使用。

📦 安裝指南

先決條件

在開始之前，請確保已安裝以下軟件：

• Docker
• PostgreSQL 數據庫 - 已運行並填充數據
• MCP 服務器

項目設置

1. 克隆倉庫 在本地機器上克隆此倉庫：

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

2. 創建 .env 文件 在倉庫根目錄下創建一個 .env 文件，包含以下變量：

DB_HOST=<你的數據庫主機>
DB_PORT=<你的數據庫端口>
DB_USER=<你的數據庫用戶名>
DB_PASSWORD=<你的數據庫密碼>
DB_NAME=<你的數據庫名稱>

將佔位符替換為實際的數據庫和 MCP 服務器連接信息。 3. 安裝 UV 包 如果你還沒有安裝，全局安裝 UV 包： astral uv

MCP 服務器設置

1. 克隆 MCP 服務器 到一個單獨的目錄。
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?"

📚 詳細文檔

• 流程和工具
  • 我們使用一個 PostgreSQL 數據庫，該數據庫通過配置對 Postgresl MCP 服務器可見。
  • from langchain_mcp_adapters.tools import load_mcp_tools 創建 MCP 工具。
  • create_react_agent 是一個快速的代理模板器。
  • 我們將流輸出到文件中。

📄 許可證

本項目根據 MIT 許可證授權。有關詳細信息，請參閱 LICENSE 文件。

⚠️ 重要提示

• 數據庫連接：檢查 .env 文件是否包含正確的數據庫憑據。
• UV 包錯誤：確保全局安裝了 UV CLI，並且 uv sync 命令完成時沒有錯誤。

💡 使用建議

隨時提出問題或提交拉取請求以改進此倉庫。

📋 待辦事項

• 輸出格式化
• 多代理支持