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

💡 使用建议

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

📋 待办事项

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