home / mcp / uniclouddb mcp server

UniCloudDB MCP Server

uniclouddb-mcp

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "6june6-uniclouddb-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "uniclouddb-mcp"
      ],
      "env": {
        "DB_SERVICE_URL": "YOUR_UNI CLOUD MCP URL",
        "REQUEST_TIMEOUT": "30000"
      }
    }
  }
}

UniCloudDB MCP is a server that exposes standard MCP endpoints to perform CRUD operations on UniCloud databases, enabling AI-assisted querying, insertion, updating, and removal of records. It provides a simple, extensible MCP toolset that you can run locally and connect to a UniCloud cloud function backend.

How to use

You run the MCP server locally and connect your MCP-enabled AI assistant to it. The server exposes four core tools you can call from your AI assistant: query, add, update, and remove. These tools let you read data, insert new records, modify existing ones, and delete records in a UniCloud collection. You configure the server with the URL of your UniCloud MCP handler and then invoke the tools with the appropriate parameters.

How to install

Prerequisites: ensure you have Node.js installed (version 18.0.0 or newer) and access to a UniCloud cloud function that serves MCP requests.

Install the MCP server package locally in your project.

npm install uniclouddb-mcp

Configuration and usage notes

Set up a local MCP runner that points to your UniCloud MCP endpoint. You can configure the MCP runner with an environment variable that specifies the cloud function URL.

You can also run the MCP service directly in your project by creating a local MCP service configuration that starts the server with Node.

Additional configuration details

Two common ways to run the MCP server are shown here. Use the exact commands and environment variable names as shown.

Core MCP tools available

The server provides a set of MCP tools you can call from your AI assistant to operate the database.

Available tools

query

Query data from a collection using JQL-style conditions and optional field selection, limit, skip, and order.

add

Insert new data into a collection. Accepts a single object or an array of objects to add.

update

Update existing records that match a where condition with new data.

remove

Delete records that match a where condition from a collection.