SkySQL MCP Server
About
SkySQL MCP Server is a Model Context Protocol server that provides an interface for managing SkySQL MariaDB database instances and interacting with AI Agents. It is designed for developers using Cursor, Windsurf, or any MCP-compatible IDE to programmatically launch serverless…
Details
- License
- MIT
Explore
- Launch and manage serverless MariaDB database instances
- Interact with AI-powered database agents
- Execute SQL queries directly on SkySQL (MySQL/MariaDB) instances
- Manage database credentials and IP allowlists
- List and monitor database services
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
SkySQL MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- Python 3.10 or higher
- A SkySQL/MariaDB Cloud API key
1. Clone the repository:
git clone [email protected]:skysqlinc/skysql-mcp.git
cd skysql-mcp
2. Run the installation script:
chmod +x install.sh
./install.sh
3. Create a .env file in the root directory of the cloned git repository with your SkySQL API key. Obtain API key by signing up for free on SkySQL.
SKYSQL_API_KEY=<your_skysql_api_key_here>
4. Start the MCP server (HTTP mode):
chmod +x launch.sh
./launch.sh
The server will start on
http://localhost:8000/mcp by default.
5. Configure your IDE:
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"skysql mcp server": {
"skysql-mcp": {
"command": "npx",
"args": [
"@wong2/mcp-cli",
"uv",
"run",
"python",
"src/mcp-server/server.py"
]
}
}
}
}McpServers
{
"skysql-mcp": {
"command": "npx",
"args": [
"@wong2/mcp-cli",
"uv",
"run",
"python",
"src/mcp-server/server.py"
]
}
}This package contains everything needed to set up the SkySQL/MariaDB Cloud MCP (Model Context Protocol) server, which provides a powerful interface for managing SkySQL MariaDB database instances and interacting with AI Agents.
Features
- Launch and manage serverless MariaDB database instances
- Interact with AI-powered database agents
- Execute SQL queries directly on SkySQL (MySQL/MariaDB) instances
- Manage database credentials and IP allowlists
- List and monitor database services
Installation
Prerequisites
- Python 3.10 or higher - A SkySQL/MariaDB Cloud API keyOption 1: Run locally
Installation steps
1. Clone the repository:
git clone [email protected]:skysqlinc/skysql-mcp.git
cd skysql-mcp
2. Run the installation script:
chmod +x install.sh
./install.sh
3. Create a .env file in the root directory of the cloned git repository with your SkySQL API key. Obtain API key by signing up for free on SkySQL.
SKYSQL_API_KEY=<your_skysql_api_key_here>
4. Start the MCP server (HTTP mode):
chmod +x launch.sh
./launch.sh
The server will start on
http://localhost:8000/mcp by default.
5. Configure your IDE:
Cursor
Add the following to your Cursor MCP config (~/.cursor/mcp.json or .cursor/mcp.json in your project):
{
"mcpServers": {
"skysql-mcp-server": {
"url": "http://localhost:8000/mcp",
"env": {
"SKYSQL_API_KEY": "<your-skysql-api-key>"
}
}
}
}
> Cursor supports passing env variables directly in the MCP config.
Windsurf
Add the following to your Windsurf MCP config (~/.codeium/windsurf/mcp_config.json):
{
"mcpServers": {
"skysql-mcp-server": {
"serverUrl": "http://localhost:8000/mcp"
}
}
}
> Note: Windsurf uses serverUrl (not url) and does not support the env parameter. Make sure SKYSQL_API_KEY is set in the .env file (step 3) or exported in your shell before starting the server.
6. (Optional) Test the server interactively with MCP CLI:
npx @wong2/mcp-cli uv run python src/mcp-server/server.py
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
