快速入門：使用 SQL MCP Server 搭配 Azure 容器應用程式

• Azure AI Foundry
• .NET Aspire
• Visual Studio 程式碼
• Azure 容器應用程式

這很重要

SQL 模型情境協定（MCP）伺服器目前處於預覽階段，本文件及引擎實作可能會有所變動。 雖然 Data API 建構器版本 1.7 仍在預覽階段，但你必須明確使用預發布版本（例如 1.7.83-rc），因為 MCP 功能尚未包含在標籤中 :latest 。

這個快速入門指南會教你如何將 SQL MCP Server 部署到 Azure 容器應用程式。 部署完成後，你可以從 Visual Studio Code（VS Code）、Microsoft Foundry 或其他任何模型情境協定（MCP）用戶端作為遠端伺服器端點連接。

先決條件

Azure 訂用帳戶

您需要作用中的 Azure 訂用帳戶。 如果您沒有帳戶，請 建立免費的 Azure 帳戶。

Azure CLI

安裝 Azure CLI 以部署資源：

Windows 作業系統

winget install Microsoft.AzureCLI

macOS

brew install azure-cli

.NET 9+

你可能已經安裝了這個工具。 執行 dotnet --version 並確認它報告的版本是 9 或更高版本。

Windows 作業系統

winget install Microsoft.DotNet.Runtime.9

macOS

brew install dotnet@9

Data API 建構器 CLI

dotnet new tool-manifest
dotnet tool install microsoft.dataapibuilder --prerelease

備註

SQL MCP Server 目前處於預發布狀態。 使用 --prerelease 這個旗標可以確保你獲得最新版本的資料 API 建構器，包含這個快速入門中使用的所有功能。

PowerShell

如果還沒安裝 PowerShell，就安裝它。

dotnet tool install --global PowerShell

步驟 1：建立並部署 Azure SQL 資料庫

1. 登入 Azure

az login
az account set --subscription "<your-subscription-id>"

2. 設定部署變數

$RESOURCE_GROUP = "rg-sql-mcp"
$LOCATION = "eastus"
$SQL_SERVER = "sql-mcp-$(Get-Random -Minimum 1000 -Maximum 9999)"
$SQL_DATABASE = "ProductsDB"
$SQL_ADMIN = "sqladmin"
$SQL_PASSWORD = "<YourStrongPassword123!>"

3. 建立資源群組

az group create \
  --name $RESOURCE_GROUP \
  --location $LOCATION

4. 建立 Azure SQL Server

az sql server create \
  --name $SQL_SERVER \
  --resource-group $RESOURCE_GROUP \
  --location $LOCATION \
  --admin-user $SQL_ADMIN \
  --admin-password $SQL_PASSWORD

5. 設定防火牆以允許 Azure 服務

az sql server firewall-rule create \
  --resource-group $RESOURCE_GROUP \
  --server $SQL_SERVER \
  --name AllowAzureServices \
  --start-ip-address 0.0.0.0 \
  --end-ip-address 0.0.0.0

6. 建立資料庫

az sql db create \
  --resource-group $RESOURCE_GROUP \
  --server $SQL_SERVER \
  --name $SQL_DATABASE \
  --service-objective S0

7. 建立包含範例資料的產品表

先拿好你的連接線：

$CONNECTION_STRING = "Server=tcp:$SQL_SERVER.database.windows.net,1433;Database=$SQL_DATABASE;User ID=$SQL_ADMIN;Password=$SQL_PASSWORD;Encrypt=true;TrustServerCertificate=false;Connection Timeout=30;"

建立一個 SQL 腳本檔 create-products.sql：

CREATE TABLE dbo.Products
(
    ProductID INT NOT NULL PRIMARY KEY IDENTITY(1,1),
    ProductName NVARCHAR(100) NOT NULL,
    Category NVARCHAR(50) NOT NULL,
    UnitPrice DECIMAL(10,2) NOT NULL,
    UnitsInStock INT NOT NULL,
    Discontinued BIT NOT NULL DEFAULT 0
);

INSERT INTO dbo.Products (ProductName, Category, UnitPrice, UnitsInStock, Discontinued) VALUES
('Laptop Pro 15', 'Electronics', 1299.99, 45, 0),
('Wireless Mouse', 'Electronics', 29.99, 150, 0),
('Office Chair', 'Furniture', 249.99, 30, 0),
('Standing Desk', 'Furniture', 599.99, 15, 0),
('Coffee Maker', 'Appliances', 89.99, 60, 0),
('Notebook Set', 'Office Supplies', 12.99, 200, 0),
('USB-C Hub', 'Electronics', 49.99, 80, 0),
('Desk Lamp', 'Furniture', 39.99, 100, 0),
('Bluetooth Headphones', 'Electronics', 149.99, 50, 0),
('Water Bottle', 'Office Supplies', 19.99, 120, 0);

使用 VS Code、SQL Server Management Studio 或 sqlcmd 執行。

步驟 2：設定 SQL MCP 伺服器

1. 創造你的 dab-config.json

初始化配置：

dab init `
  --database-type mssql `
  --connection-string "@env('MSSQL_CONNECTION_STRING')" `
  --host-mode Production `
  --config dab-config.json

2. 新增「產品」實體並添加對應描述

dab add Products `
  --source dbo.Products `
  --permissions "anonymous:read" `
  --description "Product catalog with pricing, category, and inventory information"

3. 提供 AI 代理的欄位描述上下文

新增欄位描述，幫助 AI 代理理解你的資料庫架構：

dab update Products `
  --fields.name ProductID `
  --fields.description "Unique product identifier" `
  --fields.primary-key true

dab update Products `
  --fields.name ProductName `
  --fields.description "Name of the product"

dab update Products `
  --fields.name Category `
  --fields.description "Product category (Electronics, Furniture, Office Supplies, Appliances)"

dab update Products `
  --fields.name UnitPrice `
  --fields.description "Retail price per unit in USD"

dab update Products `
  --fields.name UnitsInStock `
  --fields.description "Current inventory count available for purchase"

dab update Products `
  --fields.name Discontinued `
  --fields.description "True if product is no longer available for sale"

步驟 3：部署 SQL MCP Server 至 Azure 容器應用程式

1. 建立 Azure 容器登錄檔並建立自訂映像檔

建立容器登錄檔，並建立一個自訂映像檔，裡面嵌入你的設定：

$ACR_NAME = "acrsqlmcp$(Get-Random -Minimum 1000 -Maximum 9999)"

az acr create `
  --resource-group $RESOURCE_GROUP `
  --name $ACR_NAME `
  --sku Basic `
  --admin-enabled true

2. 建立 Dockerfile

在與dab-config.json相同的資料夾中建立一個名為Dockerfile的檔案。

FROM mcr.microsoft.com/azure-databases/data-api-builder:1.7.83-rc
COPY dab-config.json /App/dab-config.json

3. 建構並推送影像

az acr build `
  --registry $ACR_NAME `
  --image sql-mcp-server:1 `
  .

4. 建立容器應用程式環境

$CONTAINERAPP_ENV = "sql-mcp-env"
$CONTAINERAPP_NAME = "sql-mcp-server"

az containerapp env create `
  --name $CONTAINERAPP_ENV `
  --resource-group $RESOURCE_GROUP `
  --location $LOCATION

5. 部署 SQL MCP 伺服器容器

$ACR_LOGIN_SERVER = az acr show `
  --name $ACR_NAME `
  --query loginServer `
  --output tsv

$ACR_USERNAME = az acr credential show `
  --name $ACR_NAME `
  --query username `
  --output tsv

$ACR_PASSWORD = az acr credential show `
  --name $ACR_NAME `
  --query "passwords[0].value" `
  --output tsv

az containerapp create `
  --name $CONTAINERAPP_NAME `
  --resource-group $RESOURCE_GROUP `
  --environment $CONTAINERAPP_ENV `
  --image "$ACR_LOGIN_SERVER/sql-mcp-server:1" `
  --registry-server $ACR_LOGIN_SERVER `
  --registry-username $ACR_USERNAME `
  --registry-password $ACR_PASSWORD `
  --target-port 5000 `
  --ingress external `
  --min-replicas 1 `
  --max-replicas 3 `
  --secrets "mssql-connection-string=$CONNECTION_STRING" `
  --env-vars "MSSQL_CONNECTION_STRING=secretref:mssql-connection-string" `
  --cpu 0.5 `
  --memory 1.0Gi

你的資源小組應該像以下範例：

6. 取得你的 MCP 端點網址

$MCP_URL = az containerapp show `
  --name $CONTAINERAPP_NAME `
  --resource-group $RESOURCE_GROUP `
  --query "properties.configuration.ingress.fqdn" `
  --output tsv

Write-Host "Your MCP Server URL: https://$MCP_URL/mcp"

儲存這個網址——你可以用它來連接 MCP 用戶端。

7. 測試部署

curl "https://$MCP_URL/health"

你應該會看到正常的反應。

從 MCP 用戶端連接

你的 SQL MCP 伺服器現在已經部署並準備好使用。 以下是與不同客戶建立聯繫的方法：

Visual Studio Code （VS Code）

請依照 VS Code 快速入門 指南，使用已部署的 MCP 伺服器網址，而不是在本地執行。

來自 Microsoft Foundry

若要將您的 MCP 伺服器加入自訂 MCP 工具，請參考 Microsoft Foundry 快速入門 指南。

其他 MCP 用戶端

使用 Step 3.6 的 MCP 伺服器 URL 從任何相容 MCP 用戶端連線。

監視與疑難排解

查看容器應用程式日誌

az containerapp logs show \
  --name $CONTAINERAPP_NAME \
  --resource-group $RESOURCE_GROUP \
  --follow

檢查 MCP 端點健康狀況

curl "https://$MCP_URL/health"

常見問題

連線失敗錯誤

• 確保容器應用程式的入口設定為 external
• 確認 SQL 連線字串是否正確
• 請在 Azure SQL 上檢查防火牆規則

沒有回傳資料

• 確認產品表是否已建立並填入
• 檢查實體權限在 dab-config.json
• 檢視容器應用程式日誌是否有錯誤

效能很慢

• 考慮增加 CPU/記憶體配置
• 檢查是否需要放大複製品
• 檢視 Application Insights 指標

生產環境的安全最佳實務

• 啟用認證 - 設定 Microsoft Entra ID 認證，取代匿名存取
• 使用受管理身份 - 讓容器應用程式使用管理身份驗證 SQL
• 實作 CORS - 限制哪些網域可以存取你的 MCP 伺服器
• 啟用速率限制 - 防止濫用
• 使用 Azure Key Vault - 安全儲存連接字串
• 用應用程式洞察監控 - 追蹤使用與效能
• 限制權限 - 只授予必要的存取權限

清理資源

完成後，刪除資源群組以移除所有資源：

az group delete --name $RESOURCE_GROUP --yes --no-wait

完整範例劇本

這裡有一個完整的 PowerShell 腳本，能執行這個快速入門中的所有步驟。 執行前，更新租戶 ID、訂閱 ID 和密碼變數。

小提示

若需具備管理身份驗證、健康檢查及自動清理的生產環境部署，請參閱 Data API 建構器示範環境腳本。

# ============================================
# Variables - UPDATE THESE VALUES
# ============================================
$RESOURCE_GROUP = "rg-sql-mcp"
$LOCATION = "centralus"
$SQL_SERVER = "sql-mcp-$(Get-Random -Minimum 1000 -Maximum 9999)"
$SQL_DATABASE = "ProductsDB"
$SQL_ADMIN = "sqladmin"
$SQL_PASSWORD = "P@ssw0rd!"  # Replace with a strong password
$ACR_NAME = "acrsqlmcp$(Get-Random -Minimum 1000 -Maximum 9999)"
$CONTAINERAPP_ENV = "sql-mcp-env"
$CONTAINERAPP_NAME = "sql-mcp-server"

# ============================================
# Sign in to Azure
# ============================================
az login --tenant "<your-tenant-id>"
az account set --subscription "<your-subscription-id>"

# ============================================
# Check if resource group exists and create unique name
# ============================================
$RG_COUNTER = 0
$ORIGINAL_RG = $RESOURCE_GROUP
while ($true) {
    $RG_EXISTS = az group exists --name $RESOURCE_GROUP
    if ($RG_EXISTS -eq "false") {
        break
    }
    $RG_COUNTER++
    $RESOURCE_GROUP = "$ORIGINAL_RG-$RG_COUNTER"
}
Write-Host "Using resource group: $RESOURCE_GROUP" -ForegroundColor Green

# ============================================
# Step 1: Create Azure SQL Database
# ============================================
az group create --name $RESOURCE_GROUP --location $LOCATION

az sql server create `
  --name $SQL_SERVER `
  --resource-group $RESOURCE_GROUP `
  --location $LOCATION `
  --admin-user $SQL_ADMIN `
  --admin-password $SQL_PASSWORD

az sql server firewall-rule create `
  --resource-group $RESOURCE_GROUP `
  --server $SQL_SERVER `
  --name AllowAzureServices `
  --start-ip-address 0.0.0.0 `
  --end-ip-address 0.0.0.0

# Add current client IP to firewall
$MY_IP = (Invoke-RestMethod -Uri 'https://api.ipify.org?format=text')
az sql server firewall-rule create `
  --resource-group $RESOURCE_GROUP `
  --server $SQL_SERVER `
  --name AllowMyIP `
  --start-ip-address $MY_IP `
  --end-ip-address $MY_IP

az sql db create `
  --resource-group $RESOURCE_GROUP `
  --server $SQL_SERVER `
  --name $SQL_DATABASE `
  --service-objective S0

$CONNECTION_STRING = "Server=tcp:$SQL_SERVER.database.windows.net,1433;Database=$SQL_DATABASE;User ID=$SQL_ADMIN;Password=$SQL_PASSWORD;Encrypt=true;TrustServerCertificate=false;Connection Timeout=30;"

# Create sample table using sqlcmd
Write-Host "Creating Products table and sample data..." -ForegroundColor Yellow

$SQL_SCRIPT = @"
CREATE TABLE dbo.Products (
    ProductID INT NOT NULL PRIMARY KEY IDENTITY(1,1),
    ProductName NVARCHAR(100) NOT NULL,
    Category NVARCHAR(50) NOT NULL,
    UnitPrice DECIMAL(10,2) NOT NULL,
    UnitsInStock INT NOT NULL,
    Discontinued BIT NOT NULL DEFAULT 0
);

INSERT INTO dbo.Products (ProductName, Category, UnitPrice, UnitsInStock, Discontinued) VALUES
('Laptop Pro 15', 'Electronics', 1299.99, 45, 0),
('Wireless Mouse', 'Electronics', 29.99, 150, 0),
('Office Chair', 'Furniture', 249.99, 30, 0),
('Standing Desk', 'Furniture', 599.99, 15, 0),
('Coffee Maker', 'Appliances', 89.99, 60, 0);
"@

# Use Invoke-Sqlcmd if available, otherwise skip table creation
try {
    $SQL_SCRIPT | Out-File -FilePath "create-table.sql" -Encoding utf8
    sqlcmd -S "$SQL_SERVER.database.windows.net" -d $SQL_DATABASE -U $SQL_ADMIN -P $SQL_PASSWORD -i "create-table.sql"
    Remove-Item "create-table.sql" -ErrorAction SilentlyContinue
    Write-Host "Products table created successfully!" -ForegroundColor Green
} catch {
    Write-Host "Note: Could not create table automatically. You can create it manually later." -ForegroundColor Yellow
    Write-Host "SQL Script saved for manual execution if needed." -ForegroundColor Yellow
}

# ============================================
# Step 2: Configure SQL MCP Server
# ============================================
# Remove existing config if present
if (Test-Path "dab-config.json") {
    Remove-Item "dab-config.json" -Force
}

dab init `
  --database-type mssql `
  --connection-string "@env('MSSQL_CONNECTION_STRING')" `
  --host-mode Production `
  --config dab-config.json

dab add Products `
  --source dbo.Products `
  --permissions "anonymous:read" `
  --description "Product catalog with pricing, category, and inventory information"

# ============================================
# Step 3: Deploy to Azure Container Apps
# ============================================
az acr create `
  --resource-group $RESOURCE_GROUP `
  --name $ACR_NAME `
  --sku Basic `
  --admin-enabled true

# Create Dockerfile
@"
FROM mcr.microsoft.com/azure-databases/data-api-builder:1.7.83-rc
COPY dab-config.json /App/dab-config.json
"@ | Out-File -FilePath Dockerfile -Encoding utf8

az acr build --registry $ACR_NAME --image sql-mcp-server:1 .

az containerapp env create `
  --name $CONTAINERAPP_ENV `
  --resource-group $RESOURCE_GROUP `
  --location $LOCATION

# Get ACR credentials for initial deployment
$ACR_LOGIN_SERVER = az acr show --name $ACR_NAME --query loginServer --output tsv
$ACR_USERNAME = az acr credential show --name $ACR_NAME --query username --output tsv
$ACR_PASSWORD = az acr credential show --name $ACR_NAME --query "passwords[0].value" --output tsv

az containerapp create `
  --name $CONTAINERAPP_NAME `
  --resource-group $RESOURCE_GROUP `
  --environment $CONTAINERAPP_ENV `
  --image "$ACR_LOGIN_SERVER/sql-mcp-server:1" `
  --registry-server $ACR_LOGIN_SERVER `
  --registry-username $ACR_USERNAME `
  --registry-password $ACR_PASSWORD `
  --target-port 5000 `
  --ingress external `
  --min-replicas 1 `
  --max-replicas 3 `
  --secrets "mssql-connection-string=$CONNECTION_STRING" `
  --env-vars "MSSQL_CONNECTION_STRING=secretref:mssql-connection-string" `
  --cpu 0.5 `
  --memory 1.0Gi

# ============================================
# Output
# ============================================
$MCP_URL = az containerapp show `
  --name $CONTAINERAPP_NAME `
  --resource-group $RESOURCE_GROUP `
  --query "properties.configuration.ingress.fqdn" `
  --output tsv

Write-Host ""
Write-Host "Deployment complete!" -ForegroundColor Green
Write-Host "MCP Server URL: https://$MCP_URL/mcp" -ForegroundColor Cyan
Write-Host "Health check:   https://$MCP_URL/health" -ForegroundColor Cyan

相關內容

• SQL MCP 伺服器概述
• SQL MCP Server 中的資料操作工具
• 為 SQL MCP Server 新增語意描述