【案例共创】在开发者空间开发MCP Server完成对GaussDB数据库的操作

1.案例介绍

本案例展示了基于 GaussDB 纯 Python 驱动与 PQ 接口开发并部署 MCP Server，实现标准 MCP 协议下的高效数据库交互，并通过 CLINE 与 ModelArts DeepSeek V3 模型完成 LLM 推理集成。

2.案例内容

2.1概述

2.1.1案例介绍

本案例旨在演示如何基于 GaussDB 开发并部署 MCP Server。实现过程中，需结合 GaussDB 提供的纯 Python 驱动及 PQ 接口，以完成与 GaussDB 数据库的高效连接与交互。

MCP Server 的开发遵循标准 MCP 协议规范，因此可兼容任意支持该协议的客户端进行连接与操作。

在本案例中，将使用 CLINE 工具进行功能演示，并通过 ModelArts 平台提供的 DeepSeek V3 模型完成 LLM 推理能力集成。

2.1.2适用对象

企业开发者
个人开发者
高校学生

2.1.3案例时间

本案例总时长预计90分钟。

2.1.4案例流程

在云主机环境中部署 GaussDB 纯 Python 驱动
用户可直接在浏览器端与大模型进行自然语言交互，并以自然语言指令驱动 MCP 控制 GaussDB 的各类操作。
该 MCP Server 负责与 GaussDB 集群建立高效通信，实现指令解析、数据交互与结果返回。

2.1.5资源总览

本案例预计花费总计1元。

2.2操作步骤

2.2.1前置配置

2.2.1.1申请开发者空间云主机

参考下面的步骤，免费领取云主机

https://support.developer.huaweicloud.com/doc/development/resource-tools/zh-cn_topic_0000002367559525-0000002367559525

配置为Euler系统

2.2.1.2申请开通GaussDB

参考下面的步骤，免费领取GaussDB在线试用版

https://developer.huaweicloud.com/signup/75dae31d0eb04cdcab822c76d35eb9a1

等待GaussDB实例创建成功后，绑定EIP，后面在开发者空间中需要使用到EIP才能访问。

参考：https://support.huaweicloud.com/usermanual-gaussdb/gaussdb_01_160.html

绑定EIP：

记住EIP，用户名（默认root）,密码（创建数据库时自定义），端口（默认8000）。

2.2.1.3申请ModelArts免费服务

参考下面的步骤，免费体验ModelArts Studio（MaaS）预置服务

https://support.huaweicloud.com/usermanual-maas-modelarts/maas-modelarts-0020.html

按下面的步骤获取相关信息：

获取API地址和模型区域切换到“西南-贵阳一”，依次点击：ModelArts Studio->模型推理->在线推理->预置服务->免费服务->领取->调用说明->OpenAI SDK

创建API Key

API Key管理-> 创建API Key

复制保存密钥。

2.2.2 开发MCP

2.2.2.1 克隆项目

克隆github项目代码，以Desktop作为主目录（如果不是，可能会导致后面部分参数需要修改，所以参考这个即可）

在桌面点击右键，点击“在此打开终端”，大约需要1分钟，执行下面代码：

git clone https://github.com/pangpang20/mcp-gaussdb-server.gitcd mcp-gaussdb-server/gaussdb-server

安装python3.10,大约5-10分钟

开发者空间中的python版本为3.9.9，而mcp服务需要安装python3.10，执行下面代码：

sh install_python310.sh

2.2.2.2 创建虚拟环境

创建虚拟环境，并激活，执行下面代码：

pip3 install uv -i https://pypi.tuna.tsinghua.edu.cn/simpleexport PATH=$HOME/.local/bin:$PATHuv venv --python /usr/local/bin/python3.10source .venv/bin/activate# 查看python版本, 确保是3.10.14python3 -V

安装mcp，执行下面代码：

uv pip install "mcp[cli]" -i https://pypi.tuna.tsinghua.edu.cn/simpleuv pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple

2.2.2.3 安装依赖并配置环境变量

安装依赖

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

初始化pq连接,大约1分钟

sh init_pq.sh

检查, 正常返回3条记录

pip list | grep gaussdb

配置GaussDB数据库信息

cp .env.sample .env

配置数据库连接信息

填写步骤2.2.2中GaussDB的EIP和端口，用户名密码等信息

vim .envGAUSSDB_HOST=xxxGAUSSDB_PORT=8000GAUSSDB_USER=rootGAUSSDB_PASSWORD=xxxGAUSSDB_DATABASE=postgresGAUSSDB_MCP_LOG=/tmp/mcp.log

输入:wq 保存退出

2.2.2.4 MCP Server开发

编写GaussDBMCP类，用于连接数据库并执行SQL查询。现在实现了建库，建表，插入数据，查询数据等功能，如需实现其他的功能，可以参考已有的代码进行扩展。

cat gaussdb_mcp_server.py

2.2.2.5 启动MCP Server

启动封装的mcp server，执行下面代码：

sh start_mcp_server.sh

没有报错即可退出，因为后面Cline会启动mcp server。

2.2.3 使用MCP

2.2.3.1 安装vscode

使用vscode连接mcp server，下载vscode需要大约10分钟，执行下面代码：

cd ~wget https://vscode.download.prss.microsoft.com/dbazure/download/stable/7adae6a56e34cb64d08899664b814cf620465925/code-1.102.1-1752598762.el8.aarch64.rpmsudo rpm -ivh code-1.102.1-1752598762.el8.aarch64.rpm

安装后，打开vscode：

2.2.3.2 安装配置CLINE

在扩展中搜索“cline”，点击安装：

安装后配置LLM：

2.2.3.3 使用CLINE连接LLM

配置MaaS提供的Deepseek。

API Provider：选择 OpenAI Compatible

Base URL：填写步骤2.2.1.3 中的API地址

OpenAI Compatible API Key：填写步骤2.2.1.3中的API Key

Model ID：填写步骤2.2.1.3中的模型参数

提一个问题确保LLM可以正常使用，如果提示连接超时等问题，请检查上面的配置是否正确。

2.2.3.4 使用CLINE连接MCP

基于前面的MCP Server配置，点击如图步骤，打开 Configure MCP Servers。

在右侧打开的cline_mcp_settings.json中改为：

其中command中的路径如果不是按上面的默认路径，请改为实际路径即可。

{  "mcpServers": {    "gaussdb": {      "disabled": false,      "timeout": 60,      "type": "stdio",      "command": "/home/developer/Desktop/mcp-gaussdb-server/gaussdb-server/start_mcp_server.sh",      "args": []    }  }}

配置后保存，左侧会自动刷新，成功后可以看到8个工具

里面通过注解将工具的功能参数等信息都获取到了，详细细节可以查看2.2.2.4章节MCP Server开发代码。

2.2.3.5 使用MCP操作GaussDB

点击“+”，创建新的任务

指令1：

给我创建一个表student_info，学生信息，需要的字段有姓名，学号，性别，出生日期，班级，年级，其中学号是自增长的主键

因为没有配置自动提交，所以有个提交确认的步骤，点击“Approve”。

可能会遇到错误，但是LLM会自己处理，再次确认即可。如下创建成功。

可以到GaussDB中查看，登录数据管理服务-GaussDB

输入创建数据库时的密码，点击测试连接，通过后点击登录

登录后，依次点击：库管理->对象列表->Schema，选择“root”（如果在2.3.3中配置为其他数据库用户，这里就改为对应的用户名），由MCP创建的表可以查到。

指令2：

在student_info表中插入一条测试数据学号为1001，并查询出来

GaussDB中查询：

指令3：

修改student_info表中学号student_id为1001的学生信息，将姓名改为李四，并查询出来

遇到问题的时候，LLM会查询表结构