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

此仓库展示了一个非常底层的例子，演示如何与运行在 Docker 镜像中的 MCP 服务器交互，该镜像连接到 PostgreSQL 数据库以供 LangGraph 代理使用。

model context protocol

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

先决条件

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

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

流程和工具

• 我们使用一个 PostgreSQL 数据库，该数据库通过配置对 Postgresl MCP 服务器可见。
• 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 目录

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?"

待办事项：

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

故障排除

• 数据库连接：检查 .env 文件是否包含正确的数据库凭据。
• UV 包错误：确保全局安装了 UV CLI，并且 uv sync 命令完成时没有错误。

贡献

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

许可证

本项目 licensed under the MIT License。有关详细信息，请参阅 LICENSE 文件。