JinDaGe - LangGraph-MCP-Client MCP Details

article

README

🚀 语言链-MCP 客户端用于 PostgreSQL 示例

本仓库展示了一个基础示例，演示如何与运行在 Docker 镜像中的 MCP 服务器进行交互。该镜像连接到 PostgreSQL 数据库，供 LangGraph 代理使用。

MCP 是一个开放协议，它对应用程序向大语言模型（LLM）提供上下文的方式进行了标准化。可以把 MCP 想象成 AI 应用程序的 USB - C 端口。就像 USB - C 为设备提供了一个通用接口来连接各种外围设备和配件一样，MCP 为 AI 模型提供了一个通用接口来连接不同的数据源和工具。

🚀 快速开始

✨ 主要特性

展示与运行在 Docker 镜像中的 MCP 服务器交互的底层示例。
连接到 PostgreSQL 数据库，供 LangGraph 代理使用。

📦 安装指南

先决条件

在开始之前，请确保已安装以下软件：

Docker
PostgreSQL 数据库 - 已运行并填充数据
MCP 服务器

项目设置

克隆仓库 在本地机器上克隆此仓库：

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

创建 .env 文件 在仓库根目录下创建一个 .env 文件，包含以下变量：

DB_HOST=<你的数据库主机>
DB_PORT=<你的数据库端口>
DB_USER=<你的数据库用户名>
DB_PASSWORD=<你的数据库密码>
DB_NAME=<你的数据库名称>

将占位符替换为实际的数据库和 MCP 服务器连接信息。 3. 安装 UV 包 如果你还没有安装，全局安装 UV 包： astral uv

MCP 服务器设置

克隆 MCP 服务器到一个单独的目录。
运行 - docker build -t mcp/postgres -f src/postgres/Dockerfile . 来构建并标记镜像。

💻 使用示例

基础用法

同步 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 命令完成时没有错误。

💡 使用建议

随时提出问题或提交拉取请求以改进此仓库。

📋 待办事项

输出格式化
多代理支持

LangGraph-MCP-Client