SkySQL

Provides an interface to manage SkySQL database instances and interact with SkyAI Agents via the MCP.

javascript

2

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "skysqlinc-skysql-mcp": {
      "command": "npx",
      "args": [
        "@wong2/mcp-cli",
        "uv",
        "run",
        "python",
        "src/mcp-server/server.py"
      ],
      "env": {
        "SKYSQL_API_KEY": "YOUR_SKYSQL_API_KEY"
      }
    }
  }
}

SkySQL MCP Server provides a streamlined interface for managing SkySQL database instances and interacting with SkyAI Agents using the Model Context Protocol. You can launch serverless MariaDB instances, run SQL queries, and oversee credentials and access controls from a single MCP-enabled endpoint.

How to use

You will use an MCP client to connect to the SkySQL MCP Server. The server runs as a local process via the MCP CLI, which then invokes the Python-based server component. With the MCP client, you can start the server, send SQL queries to SkySQL instances, and work with SkyAI Agents through the same interface. Use the client to manage sessions, run commands, and monitor results, all within a consistent MCP workflow.

How to install

Prerequisites: Python 3.10 or higher and a SkySQL API key.

Option 1 Run locally

Clone the project directory and navigate into it.

git clone git@github.com:skysqlinc/skysql-mcp.git
cd skysql-mcp

Run the installation script.

chmod +x install.sh
./install.sh

Create a .env file in the root directory and insert your SkySQL API key.

SKYSQL_API_KEY=<your_skysql_api_key_here>

Test the server interactively using the MCP CLI. This starts the server via the MCP wrapper and the Python entrypoint.

npx @wong2/mcp-cli uv run python src/mcp-server/server.py

Configure Cursor.sh for your environment. On Mac/Linux, make Launch script executable and update the mcp.json with your paths and API key.

chmod +x launch.sh

Update mcp.json:

command "<full-path-to>/skysql-mcp/launch.sh" for Mac/Linux
command ""<full-path-to>\skysql-mcp\launch.bat" for Windows
SKYSQL_API_KEY with your SkySQL API key

## Option 2 Installing via Smithery.ai

You can test the MCP server through Smithery.ai’s UI. Follow their install instructions to deploy and run the server.

npx -y @smithery/cli@latest install @skysqlinc/skysql-mcp --client cursor --profile <your-smithery-profile> --key <your-smithery-kay>


Windsurf:

npx -y @smithery/cli@latest install @skysqlinc/skysql-mcp --client windsurf --profile <your-smithery-profile> --key <your-smithery-key>


## Available tools

### launchDatabase

Launch and manage serverless SkySQL database instances within the MCP environment.

### executeQuery

Execute SQL queries directly on SkySQL (MySQL/MariaDB) instances from the MCP interface.

### manageCredentials

Manage database credentials and IP allowlists to control access to SkySQL instances.

### monitorServices

List and monitor database services and their status from the MCP server.