🚀 语言链-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命令完成时没有错误。
💡 使用建议
随时提出问题或提交拉取请求以改进此仓库。
📋 待办事项
- 输出格式化
- 多代理支持