SkySQL MCP Server

SkySQL MCP 服务

此软件包包含设置 SkySQL/MariaDB Cloud MCP（Model Context Protocol）服务所需的一切，该服务提供强大的接口，用于管理 SkySQL MariaDB 数据库实例并与 AI Agent 交互。

功能

• 启动和管理无服务器 MariaDB 数据库实例
• 与 AI 驱动的数据库 Agent 交互
• 直接在 SkySQL（MySQL/MariaDB）实例上执行 SQL 查询
• 管理数据库凭据和 IP 允许列表
• 列出并监控数据库服务

安装

先决条件

• Python 3.10 或更高版本
• SkySQL/MariaDB Cloud API 密钥

选项 1：本地运行

安装步骤

1. 克隆仓库：

   git clone [email protected]:skysqlinc/skysql-mcp.git
   cd skysql-mcp
   

2. 运行安装脚本：

   chmod +x install.sh
   ./install.sh
   

3. 在克隆的 git 仓库根目录中创建 .env 文件，并填入 SkySQL API 密钥。注册 SkySQL 即可免费获取 API 密钥。

   SKYSQL_API_KEY=<your_skysql_api_key_here>
   

4. 启动 MCP 服务（HTTP 模式）：

   chmod +x launch.sh
   ./launch.sh
   

   服务默认会在 http://localhost:8000/mcp 启动。

5. 配置 IDE：

Cursor

将以下内容添加到 Cursor MCP 配置中（~/.cursor/mcp.json 或项目中的 .cursor/mcp.json）：

{
  "mcpServers": {
    "skysql-mcp-server": {
      "url": "http://localhost:8000/mcp",
      "headers": {
        "X-API-Key": "<your-skysql-api-key>"
      }
    }
  }
}

每次请求都会发送 X-API-Key 标头，因此服务器托管在远程时可使用每位用户各自的 API 密钥。

Windsurf

将以下内容添加到 Windsurf MCP 配置中（~/.codeium/windsurf/mcp_config.json）：

{
  "mcpServers": {
    "skysql-mcp-server": {
      "serverUrl": "http://localhost:8000/mcp"
    }
  }
}

**注意：**Windsurf 使用 serverUrl（而非 url），且无法发送请求标头。请以单租户模式启动 服务，使其回退使用环境中的 API 密钥：

SKYSQL_SINGLE_TENANT=true ./launch.sh

并在 .env 中设置 SKYSQL_API_KEY（步骤 3）。如果未设置 SKYSQL_SINGLE_TENANT，服务 会要求每个 HTTP 调用方提供自己的 X-API-Key 标头，并拒绝未提供标头的请求——这是有意为之， 以确保共享部署绝不会使用运营方的密钥处理请求。

Claude

将服务添加为自定义连接器（Settings > Connectors > Add custom connector），然后在 Request headers 下填写 API 密钥：

字段	值
URL	已部署的服务 URL，以 /mcp 结尾
标头名称	x-api-key
标头值	SkySQL API 密钥，不带前缀
必填	是

在 app.skysql.com/user-profile/api-keys 生成密钥。 按原样输入即可——Claude 会原样发送该值，不会添加方案或前缀。

Claude 要求 URL 必须是可公开访问的 HTTPS 地址，因此此处无法使用 http://localhost:8000/mcp；请先部署服务。请求标头身份验证目前处于 Beta 阶段，可能需要为组织启用。

6.（可选）使用 MCP CLI 交互式测试服务：

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