SkySQL MCP Server

SkySQL MCP サーバー

このパッケージには、SkySQL/MariaDB Cloud MCP（Model Context Protocol）サーバーのセットアップに必要なものがすべて含まれています。このサーバーは、SkySQL MariaDB データベースインスタンスを管理し、AI エージェントと連携するための強力なインターフェースを提供します。

機能

• サーバーレスの MariaDB データベースインスタンスを起動、管理します
• AI 搭載のデータベースエージェントと連携します
• 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 は url ではなく serverUrl を使用し、リクエストヘッダーを送信できません。環境内の 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 には外部からアクセス可能な HTTPS URL が必要なため、ここでは http://localhost:8000/mcp は使用できません。先にサーバーをデプロイしてください。リクエストヘッダー認証は現在ベータ版であり、組織で有効化が必要な場合があります。

6. （任意）MCP CLI を使ってサーバーを対話的にテストします：

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