PostgreSQL MCP Server with LLM Chat Example on Clever Cloud

PostgreSQL MCP Server with LLM Chat Example on Clever Cloud

site icon
2025.05.09 0
JavaScript数据库查询自然语言处理数据库开发效率
mcp-pg-example 是一个基于 Node.js 的应用程序,展示了如何在 Clever Cloud 上部署一个使用 Model Context Protocol (MCP) 服务器与 PostgreSQL 数据库交互的应用。该应用通过自然语言查询数据库,利用语言模型 (LLM) 将自然语言转换为 SQL 查询,并通过 MCP 服务器执行这些查询。
View on GitHub

Overview

基本能力

产品定位

mcp-pg-example 是一个演示项目,展示了如何将 MCP 服务器与 PostgreSQL 数据库结合使用,通过自然语言查询数据库。

核心功能

  • PostgreSQL 数据库的自然语言查询
  • MCP 服务器与 PostgreSQL 的集成
  • LangChain.js 集成用于 LLM 交互
  • 简单的 Web 界面用于与数据库对话
  • Express.js 后端提供 API 端点

适用场景

  • 数据库探索与查询
  • 自然语言处理与数据库交互的演示
  • 开发与测试 MCP 服务器与 PostgreSQL 的集成

工具列表

  • Clever Tools CLI: 用于部署和管理 Clever Cloud 上的应用
  • Node.js: 运行应用程序的 JavaScript 运行时
  • PostgreSQL: 数据库管理系统
  • LangChain.js: 用于与 LLM 交互的库

常见问题解答

  1. 如何检查应用日志?
  2. 使用命令 clever logs
  3. 如何验证环境变量是否正确设置?
  4. 使用命令 clever env
  5. 如何确保应用正在运行?
  6. 使用命令 clever status

使用教程

使用依赖

  1. 安装 Node.js 23 或更高版本
  2. 安装 PostgreSQL 数据库
  3. 获取 LLM API 密钥(如 OpenAI)
  4. 安装 Clever Tools CLI: bash npm install -g clever-tools

安装教程

  1. 克隆仓库
  2. 安装依赖: bash npm install
  3. 配置环境变量: bash cp .env.example .env
  4. 更新 .env 文件中的 PostgreSQL 连接详情和 LLM API 密钥
  5. 初始化数据库: bash node scripts/initializeDb.js
  6. 测试 MCP 服务器和 LLM 集成: bash node scripts/testMCP.js
  7. 启动开发服务器: bash npm run dev

调试方式

  1. 检查应用日志: bash clever logs
  2. 验证环境变量: bash clever env
  3. 检查应用状态: bash clever status

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。