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
- Author
- skysqlinc
- GitHub stars
- 6
- Downloads
- 202
- Categories
- Other
Jump to
- 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
Install Python 3.10+ and obtain a SkySQL API key. Clone the repository, run install.sh, create a .env file with SKYSQL_API_KEY, then start the server with launch.sh (listens on http://localhost:8000/mcp by default). Configure your IDE (Cursor or Windsurf) by adding the server URL and environment variables to its MCP config file. Optionally test with npx @wong2/mcp-cli.
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"
]
}
}SkySQL MCP Server
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 git@github.com: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.
