UniCloudDB-MCP

基于MCP协议的UniCloud数据库操作工具，支持通过AI助手进行CRUD数据库操作。

功能

• 支持标准化的MCP协议工具集成
• 提供完整的JQL格式数据库操作接口
• 支持查询、添加、更新和删除等常见操作
• 简单易用的API设计
• 适应主流AI模型工具调用
• 支持本地操作，修改源代码

直接配置MCP以使用

{
 "uniclouddb-mcp": {
    "command": "npx",
    "args": ["-y", "uniclouddb-mcp"],
    "env": {
      "DB_SERVICE_URL": "https://你的uniCloud云函数URL.next.bspapp.com/mcp"
    }
  }
}

本地操作使用方法

安装

npm install uniclouddb-mcp

环境变量配置

可以通过环境变量配置数据库服务参数：

# 配置文件
DB_SERVICE_URL=https://你的uniCloud云函数URL/mcp
REQUEST_TIMEOUT=30000

将mcp-uservice文件夹复制到您项目的uniCloud/cloudfunctions目录并上传云函数

打开UniCloud Web控制台，找到mcp_service云函数，并设置云函数为基于URL的

通过HTTP或HTTPS设置访问此云函数的URL。域名在云函数列表界面绑定，仅设置路径。参考文档：https://uniapp.dcloud.io/uniCloud/http

设置MCP服务

{
 "uniclouddb": {
      "name": "uniclouddb",
      "key": "uniclouddb",
      "command": "node",
      "args":[
        "D:\\uniCloudDB-mcp\\index.js"
      ],
      "disabled": false,
      "env": {}
  }
}

MCP工具描述

该库提供了以下可以直接由AI助手调用的MCP工具：

1. 查询 - 查询数据

参数

• collection: 集合名称
• where查询条件（JQL格式）
• field(可选): 返回字段
• limit(可选): 返回数量限制
• skip(可选): 跳过记录数
• orderBy(可选): 排序条件

2. 添加 - 添加数据

参数

• collection: 集合名称
• data: 待添加的数据（对象/数组）

3. 更新 - 更新数据

参数

• collection: 集合名称
• where更新条件（JQL格式）
• data: 待更新的数据（对象）

4. 删除 - 删除数据

参数

• collection: 集合名称
• where删除条件（JQL格式）

数据库连接测试

使用内置测试工具验证数据库连接性和基本功能：

npm test

系统需求

• Node.js >= 18.0.0
• 部署UniCloud云函数

UniCloud云函数集成

此工具需要与uniCloud云函数配合使用。请确保已部署相应的处理函数。 云函数接收标准JQL格式请求，处理数据库操作并返回结果。

安全提醒

• 建议在生产环境中配置访问控制和认证
• 避免在公共环境中暴露数据库URL
• 定期更新依赖包以修复潜在的安全问题

许可证

MIT