這很重要
SQL 模型情境協定（MCP）伺服器目前處於預覽階段，本文件及引擎實作可能會有所變動。 雖然 Data API 建構器版本 1.7 仍在預覽階段，但你必須明確使用預發布版本（例如 1.7.83-rc），因為 MCP 功能尚未包含在標籤中 :latest 。
這個快速入門工具使用 Data API 建構工具的 CLI 在本地執行 SQL MCP 伺服器，無需 Aspire。 你建立資料庫、設定設定檔、啟動 SQL MCP Server，並用自訂工具從 Visual Studio Code（VS Code）連接。 這條路是探索 SQL MCP Server 最簡單的方式，無需容器或主機框架。
先決條件
在開始之前先安裝這些工具。
.NET 9+
你可能已經安裝了這個工具。 執行 dotnet --version 並確認它顯示的是 9.0 或更新版本。 如果 .NET 已經存在，重新安裝是安全的，只會刷新執行時。
SQL Server 2016+
你需要存取 SQL Server 資料庫。 以下任一項工作：
- SQL Server（開發版或 Express 版）
- LocalDB（基於檔案的 SQL Server）
- Docker 中的 SQL Server
安裝資料 API 產生器 CLI
dotnet new tool-manifest
dotnet tool install microsoft.dataapibuilder --prerelease
dotnet tool restore
備註
SQL MCP Server 目前處於預發布狀態。 使用 --prerelease 這個旗標可以確保你獲得最新版本的資料 API 建構器，包含這個快速入門中使用的所有功能。
步驟一：建立您的樣本資料庫
在此步驟中，你建立一個名為 ProductsDb 的資料庫，並以一個名為 Products的單一資料表做種子。
使用 SQLCMD、SQL Server Management Studio 或任何偏好的工具連接到你的 SQL 實例，然後執行：
CREATE DATABASE ProductsDb;
GO
USE ProductsDb;
GO
CREATE TABLE dbo.Products (
Id INT PRIMARY KEY,
Name NVARCHAR(100) NOT NULL,
Inventory INT NOT NULL,
Price DECIMAL(10,2) NOT NULL,
Cost DECIMAL(10,2) NOT NULL
);
INSERT INTO dbo.Products (Id, Name, Inventory, Price, Cost)
VALUES
(1, 'Action Figure', 40, 14.99, 5.00),
(2, 'Building Blocks', 25, 29.99, 10.00),
(3, 'Puzzle 500 pcs', 30, 12.49, 4.00),
(4, 'Toy Car', 50, 7.99, 2.50),
(5, 'Board Game', 20, 34.99, 12.50),
(6, 'Doll House', 10, 79.99, 30.00),
(7, 'Stuffed Bear', 45, 15.99, 6.00),
(8, 'Water Blaster', 35, 19.99, 7.00),
(9, 'Art Kit', 28, 24.99, 8.00),
(10,'RC Helicopter', 12, 59.99, 22.00);
你的樣本資料庫已經準備好了。
步驟 2：設定 SQL MCP 伺服器
在你想建立 dab-config.json 檔案的資料夾裡執行所有指令。
建立你的環境檔案
在你的工作目錄中建立一個檔案名稱 .env ，並新增以下一行（可自訂你的 SQL Server 資訊）：
MSSQL_CONNECTION_STRING=Server=localhost;Database=ProductsDb;Trusted_Connection=True;TrustServerCertificate=True
備註
整合驗證（Trusted_Connection=True）在 Windows 上是可運作的。 如果是 SQL 認證（Docker 或跨平台常見），請改用 Server=localhost,1433;Database=ProductsDb;User Id=sa;Password=<YourPassword>;TrustServerCertificate=True （假設你的容器將 port 1433 映射到 localhost）。
Data API 建構器可以從工作目錄中的本地檔案 .env 讀取變數。 如果你的環境不支援 .env 檔案，請先在終端機工作階段中將環境變數設 MSSQL_CONNECTION_STRING 為，然後再執行以下指令。
初始化並設定伺服器
執行以下命令：
dab init --database-type mssql --connection-string "@env('MSSQL_CONNECTION_STRING')" --host-mode Development --config dab-config.json
dab add Products --source dbo.Products --permissions "anonymous:read" --description "Toy store products with inventory, price, and cost."
可選擇性地加入欄位描述
dab update Products --fields.name Id --fields.primary-key true --fields.description "Product Id"
dab update Products --fields.name Name --fields.description "Product name"
dab update Products --fields.name Inventory --fields.description "Units in stock"
dab update Products --fields.name Price --fields.description "Retail price"
dab update Products --fields.name Cost --fields.description "Store cost"
你的 SQL MCP 伺服器已經完全設定好了。
步驟 3：啟動 SQL MCP 伺服器
在從 VS Code 連接前，先在獨立終端機啟動 SQL MCP 伺服器。
打開終端機並執行
dab start --config dab-config.json
此指令啟動 SQL MCP 伺服器。 啟動後，終端機輸出會顯示監聽網址。 此快速入門假設 MCP 端點為 http://localhost:5000/mcp。 保持這個終端機運作——Visual Studio Code 會連接到這個 HTTP 端點。
備註
你可以透過配置您的 dab-config.json 的執行階段設定，或設定環境變數（例如 ASPNETCORE_URLS）來自訂端口。
步驟 4：從 VS Code 連接
這很重要
Workspace 是 VS Code 視為你專案的根目錄。 設定和 MCP 伺服器定義只適用於該資料夾內。 如果你只開啟一個檔案，你就不在工作區裡。 你必須打開一個資料夾。
打開你的專案資料夾
- 選擇「 檔案>開啟資料夾」。
- 打開包含你
dab-config.json檔案的資料夾。
建立你的 MCP 伺服器定義
建立一個名為 .vscode/mcp.json 檔案的檔案並新增以下內容：
{
"servers": {
"sql-mcp-server": {
"type": "http",
"url": "http://localhost:5000/mcp"
}
}
}
儲存檔案。 VS Code 會自動偵測 MCP 伺服器的設定。 你可能需要重新載入視窗（開發者：從指令面板重新載入視窗 ）。
啟動 MCP 伺服器連線
- 打開指令面板（macOS 用 Ctrl+Shift+P 或 Cmd+Shift+P ）。
- 執行 MCP：List 伺服器 以查看可用伺服器。
- 選擇 sql-mcp-server ，然後選擇 開始 連線。
一旦連接，該 Products 實體會以 MCP 工具的形式呈現，例如 describe_entities 和 read_records。 工具名稱會依你的配置而有所不同。
備註
VS Code MCP 支援正在演進中。 未來版本可能會變更配置架構。 最新指引請參閱 VS Code 關於 MCP 整合的文件。
試著用工具呼叫
打開 VS Code 副駕駛聊天，試試這個提示：
Which products have an inventory under 30?